Get Malaysia E-Invoice Copy from Tax Authority | Staple AI

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

{
  "uuid": "HRHMBPSMFWB43SRAH7DEWHMK10",
  "longId": "4GKW9K2K78WE1WZ1H7DEWHMK10svDqEC1774421751"
}

Minimal Payload

{
  "uuid": "HRHMBPSMFWB43SRAH7DEWHMK10"
}

Response (Success)

{
  "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.

Authentication

x-api-keystring

API key issued by Staple.

AuthorizationBearer

JWT obtained from the login endpoint.

Request

This endpoint expects an object.

uuidstringOptional