Skip to navigation
V2E Invoice

Get Malaysia E-Invoice Status

View as Markdown

Retrieve the latest processing status of a Malaysia e-invoice document using Staple docId.

Staple uses the provided docId to return the latest document status and MyInvois information (if available).

Note:
The initial import/queue response only confirms that the document was accepted for processing.
Clients should call the status endpoint to get the final processing result.

Endpoint

GET /v2/einvoice/malaysia/status/{docId}

Request Headers

AttributeTypeOptionDescription
x-api-keyStringRequiredA unique string
AuthorizationStringRequiredBearer token

Accept: application/json

Path Parameter

AttributeTypeOptionDescription
docIdNumberRequiredStaple document ID returned by the import endpoint

Response Fields

FieldTypeDescription
docIdNumberStaple document ID
docTypeStringDocument type, for example invoice
docNumberStringInvoice or document number
statusStringCurrent document status
validatedAtStringnull
cancelDateTimeStringnull
documentStatusReasonStringnull
myInvoisObjectMyInvois identifiers and validation link
errorsArraynull

Status Values

statusMeaning
ValidSuccessfully validated by MyInvois
InvalidRejected or failed validation
CancelledCancelled on MyInvois

myInvois Object

FieldTypeDescription
submissionIdStringnull
uuidStringnull
longIdStringnull
validationLinkStringnull

Important:
When the document is invalid, the myInvois fields may be null.

errors[]

Returned when the document is invalid.

FieldTypeDescription
codeStringValidation error code
messageStringHuman-readable error message
fieldStringField associated with the validation error

Response Examples

Valid

{
  "docId": 242020,
  "docType": "invoice",
  "docNumber": "INV-2026-0001",
  "status": "Valid",
  "validatedAt": "2026-03-26T07:01:56Z",
  "cancelDateTime": null,
  "documentStatusReason": null,
  "myInvois": {
    "submissionId": "KBYDN7AFC3BFQFG4PY86FMMK10",
    "uuid": "KAQ2848KJ35CCAH3PY86FMMK10",
    "longId": "R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516",
    "validationLink": "https://preprod.myinvois.hasil.gov.my/KAQ2848KJ35CCAH3PY86FMMK10/share/R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516"
  },
  "errors": null
}

Invalid

{
  "docId": 242071,
  "docType": "invoice",
  "docNumber": "INV-2026-0001",
  "status": "Invalid",
  "validatedAt": null,
  "cancelDateTime": null,
  "documentStatusReason": "[einvoice-my] Submission rejected. INV-2026-000-test11 | 2 | Validation Error | CF321: DatetimeIssued: Issuance date time value of the document is too old that cannot be submitted.",
  "myInvois": {
    "submissionId": null,
    "uuid": null,
    "longId": null,
    "validationLink": null
  },
  "errors": [
    {
      "code": "CF321",
      "message": "Issuance date time value of the document is too old that cannot be submitted.",
      "field": "DatetimeIssued"
    }
  ]
}

Cancelled

{
  "docId": 242020,
  "docType": "invoice",
  "docNumber": "INV-2026-0001",
  "status": "Cancelled",
  "validatedAt": "2026-03-26T07:01:56Z",
  "cancelDateTime": "2026-03-26T08:15:00Z",
  "documentStatusReason": null,
  "myInvois": {
    "submissionId": "KBYDN7AFC3BFQFG4PY86FMMK10",
    "uuid": "KAQ2848KJ35CCAH3PY86FMMK10",
    "longId": "R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516",
    "validationLink": "https://preprod.myinvois.hasil.gov.my/KAQ2848KJ35CCAH3PY86FMMK10/share/R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516"
  },
  "errors": null
}

Notes

  • Use this endpoint to get the final processing result after import/queue.

  • status values are returned in the current API format, such as Valid, Invalid, and Cancelled.

  • For invalid documents, check both documentStatusReason and errors[] for troubleshooting.

Authentication

x-api-keystring
API key issued by Staple.
AuthorizationBearer
JWT obtained from the login endpoint.

Response

OK