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.

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.

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.

$	curl -X POST https://api.staple.io/v2/einvoice/singapore/submit-tax \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"docIds": [
>	245210,
>	245211
>	]
>	}'