Received documents · SUMU API Docs

Documents sent to your taxpayers arrive automatically. Fetch them by id, or receive them by webhook as they land — see Webhooks.

GET/v1/api/documents/{document_id}

parsed is read from the received XML, not reconstructed — it's what the sender actually transmitted. pdf_url is a readable rendering SUMU generates; the XML remains the legal original.

REQUEST

cURL

curl https://api.joinsumu.com/v1/api/documents/d51c8b3a-1234-4a1b-9c2d-3e4f5a6b7c8d \
-H "X-API-Key: sumu_live_..."

RESPONSE200 OK

application/json

{
"document_id": "d51c8b3a-...",
"direction": "inbound",
"document_type": "Invoice",
"document_type_code": "380",
"received_at": "2026-08-13T10:30:45Z",
"recipient_taxpayer_id": "625919e2-...",
"sender": { "scheme": "0248", "identifier": "OM1100446274", "name": "Seller LLC" },
"receiver": { "scheme": "0248", "identifier": "OM1100449001", "name": "Demo Trading LLC" },
"xml_url": "https://... (expires in 15 minutes)",
"pdf_url": "https://... (expires in 15 minutes)",
"parsed": {
  "invoice_number": "EINV-0001",
  "issue_date": "2026-08-12",
  "due_date": "2026-09-11",
  "currency": "OMR",
  "total_excluding_tax": "422.75",
  "total_tax": "21.14",
  "total_including_tax": "443.89",
  "supplier": { "name": "Seller LLC", "vat_id": "OM1100446274" },
  "customer": { "name": "Demo Trading LLC", "vat_id": "OM1100449001" },
  "lines": [
    {
      "position": "1",
      "name": "Oak veneer panel",
      "quantity": "12",
      "unit_code": "H87",
      "unit_price": "23.750",
      "line_amount": "270.750",
      "tax_category": "S",
      "tax_percent": "5"
    }
  ]
}
}