BizCARE MyInvois
API Reference

Submitted Documents

API endpoint for listing all submitted documents

Submitted Documents API

List all documents that have been submitted to LHDN's MyInvois system across all invoices, consolidated invoices, and adjustment notes.

For submitted documents associated with a specific invoice or adjustment note, see the respective endpoints:


List Submitted Documents

Endpoint

GET /api/submitted-documents

Headers

HeaderValue
X-API-KeyYour API key

Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number
per_pagenumber10Items per page

Response

{
  "meta": {
    "total": 4,
    "per_page": 10,
    "current_page": 1,
    "last_page": 1,
    "first_page": 1,
    "first_page_url": "/?page=1",
    "last_page_url": "/?page=1",
    "next_page_url": null,
    "previous_page_url": null
  },
  "data": [
    {
      "id": 16,
      "document_submission_id": 16,
      "adjustment_note_id": null,
      "invoice_id": 20,
      "consolidated_invoice_id": null,
      "company_id": 7,
      "user_id": 80,
      "code": "INV-7",
      "uuid": "F5Y7MVEV04QDJ45EAGVD07JK10",
      "status": "Valid",
      "fail_reason": null,
      "fail_details": null,
      "document_details": { "...": "UBL XML JSON snapshot (see below)" },
      "type": "INVOICE",
      "cancel_reason": null,
      "long_id": "XN1SYJT77XKV9F856JCV7G3K10lyrOOY1756112990",
      "created_at": "2025-08-25T09:09:49.982+00:00",
      "updated_at": "2025-08-25T09:10:51.128+00:00"
    }
  ]
}

The document_details field contains the full UBL XML JSON snapshot of the document as submitted to LHDN's MyInvois system. This is a large nested object following the OASIS UBL 2.1 Invoice schema and is not typed — treat it as an opaque JSON value.

Code Examples

cURL

curl -X GET "https://api.bizcare-einvoice.com/api/submitted-documents?page=1&per_page=10" \
  -H "X-API-Key: your-api-key-here"

JavaScript

const response = await fetch(
  'https://api.bizcare-einvoice.com/api/submitted-documents?page=1&per_page=10',
  { headers: { 'X-API-Key': 'your-api-key-here' } }
);
const data = await response.json();

Python

response = requests.get(
    'https://api.bizcare-einvoice.com/api/submitted-documents',
    headers={'X-API-Key': 'your-api-key-here'},
    params={'page': 1, 'per_page': 10},
)

PHP

$response = Http::withHeaders([
    'X-API-Key' => 'your-api-key-here',
])->get('https://api.bizcare-einvoice.com/api/submitted-documents', [
    'page' => 1,
    'per_page' => 10,
]);