Get Malaysia E-Invoice Copy from Tax Authority

# Get Malaysia E-Invoice Tax Copy Retrieve the tax authority copy for a Malaysia e-invoice document. This endpoint returns the tax authority representation of the document, including: - document `uuid` - current `status` - raw tax authority payload - metadata - normalized summary You can request the tax copy by sending: - `uuid` only, or - `uuid` together with `longId` (optional) * * * ## Endpoint **POST** `/v2/einvoice/malaysia/taxcopy` * * * ## Request Headers | Attribute | Type | Option | Description | | --- | --- | --- | --- | | x-api-key | String | Required | A unique string | | Authorization | String | Required | Bearer token | **Content-Type:** `application/json` **Accept:** `application/json` * * * ## Request Payload | Field | Type | Required | Description | | --- | --- | --- | --- | | uuid | String | ✅ | MyInvois document UUID | | longId | String | Optional | MyInvois long ID. Can be provided to help identify the validation/share record | ### Sample Payload ```json { "uuid": "HRHMBPSMFWB43SRAH7DEWHMK10", "longId": "4GKW9K2K78WE1WZ1H7DEWHMK10svDqEC1774421751" } ``` ### Minimal Payload ```json { "uuid": "HRHMBPSMFWB43SRAH7DEWHMK10" } ``` * * * ## Response (Success) ```json { "uuid": "KAQ2848KJ35CCAH3PY86FMMK10", "status": "valid", "taxAuthority": { "sourceFormat": "json", "raw": { "...": "raw tax authority payload" }, "metadata": { "submissionId": "KBYDN7AFC3BFQFG4PY86FMMK10", "longId": "R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516", "validationLink": "https://preprod.myinvois.hasil.gov.my/KAQ2848KJ35CCAH3PY86FMMK10/share/R0KWNJ08TAD6Z6NPPY86FMMK10em8pIp1774508516", "validatedAt": "2026-03-26T07:01:56Z", "documentType": "invoice", "currency": "MYR", "statusReason": null, "cancelDateTime": null, "rejectRequestDateTime": null }, "summary": { "docNumber": "INV-2026-0001", "issueDate": "2026-03-24", "issueTime": "09:44:25Z", "currency": "MYR", "supplier": { "name": "Seller Sdn Bhd", "tin": "IG59605712010" }, "buyer": { "name": "Buyer Sdn Bhd", "tin": "C59584904000" }, "amounts": { "totalExclTax": 150, "taxTotal": 18, "totalInclTax": 168, "payableAmount": 168 } } } } ``` * * * ## Response Fields ### Top-level Fields | Field | Type | Description | | --- | --- | --- | | uuid | String | MyInvois document UUID | | status | String | Current status of the document | | taxAuthority | Object | Tax authority copy, metadata, and normalized summary | ### `taxAuthority` Fields | Field | Type | Description | | --- | --- | --- | | sourceFormat | String | Format of the tax authority source payload, e.g. `json` | | raw | Object | Full raw payload returned/stored from tax authority | | metadata | Object | Tax authority metadata and tracking information | | summary | Object | Simplified normalized document summary | ### `taxAuthority.metadata` Fields | Field | Type | Description | | --- | --- | --- | | submissionId | String | null | | longId | String | null | | validationLink | String | null | | validatedAt | String | null | | documentType | String | null | | currency | String | null | | statusReason | String | null | | cancelDateTime | String | null | | rejectRequestDateTime | String | null | ### `taxAuthority.summary` Fields | Field | Type | Description | | --- | --- | --- | | docNumber | String | Document number | | issueDate | String | Issue date | | issueTime | String | Issue time | | currency | String | Currency code | | supplier | Object | Simplified supplier info | | buyer | Object | Simplified buyer info | | amounts | Object | Simplified total amounts | * * * ## Notes - `uuid` is the main identifier for this endpoint. - `longId` is optional. - `taxAuthority.raw` contains the full authority-side payload and may be large. - `taxAuthority.summary` is the simplified view for easier API consumption. - `validationLink` may be present when the document has been validated. * * * ## Errors ### 502 / 503 Upstream Unavailable Returned when MyInvois or upstream dependency is temporarily unavailable.