Submit tax to IRAS | Staple AI

Submit the tax data of one or more Singapore e-invoices to IRAS (Inland Revenue Authority of Singapore).

Primarily used for reporting the tax of a received e-invoice (delivered via the Peppol inbound webhook) to IRAS. Pass the internal document IDs (docIds) of the landed documents.

The call is all-or-nothing: every document is submitted together, or the request fails.

Outcome	HTTP	Meaning
`status: SUCCESS`	200	Accepted by IRAS.
`status: FAILED`	400	A document was not found, is in a state that cannot be submitted, or belongs to a queue you cannot access.

Submission is tracked per document — poll GET /v2/supernova/models/document/{requestId} for irasTaxSubmissionStatus.

Authentication

x-api-keystring

API key issued by Staple.

AuthorizationBearer

JWT obtained from the login endpoint.

Request

This endpoint expects an object.

docIdslist of integersRequired

Internal document IDs of the e-invoices to report to IRAS.

Response

Accepted by IRAS.