Skip to main content

GET /v1/invoices/{docId}/status

Checks the status of a submission. Useful for clients that cannot receive webhooks.

curl https://sandbox.api.erply.pro/v1/invoices/$DOC_ID/status \
-H "Authorization: Bearer $TOKEN"

Response

{
"docId": "01HW9X4G…",
"trackId": "20260501-DGII-9988",
"status": "accepted",
"dgii": {
"approvedAt": "2026-05-01T17:42:11Z",
"trackId": "20260501-DGII-9988"
}
}

Possible statuses

statusDescription
pendingQueued or awaiting DGII ACK.
acceptedDGII accepted.
rejectedRejection (consult dgii.code).

Possible errors

HTTPSlug
401unauthorised
404https://errors.api.erply.pro/not-found

Polling vs webhook

  • Webhook (recommended): ERPly Pro calls you as soon as DGII responds — no polling.
  • Polling: call every 30 s; Free plans allow ≤ 120 polls/h per tenant.