Get an invoice by ZUTAX UUID

GET

/api/public/v1/invoices/{invoice_id}

Code sample: cURL

curl --request GET \
  --url 'https://api.getzutax.com/api/public/v1/invoices/f3df2967-7cbe-4cca-8c8c-975ee2f6857f' \
  --header 'Authorization: Bearer <token>'

• Production API
• Staging API

Authorizations

• HTTPBearer

Parameters

Path Parameters

invoice_id

required

Invoice Id

string format: uuid

Responses

200

Successful Response

Media type application/json

InvoiceResponse

object

id

required

Id

string format: uuid

external_id

required

Any of:

string

string

null

null

status

required

Status

string

Allowed values: draft submitted validated dispatched delivered accepted rejected paid cancelled

invoice_number

Any of:

string

string

null

null

irn

Any of:

string

string

null

null

currency

required

Currency

string

issue_date

required

Issue Date

string format: date

due_date

required

Due Date

string format: date

subtotal_naira

required

Subtotal Naira

string

/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/

vat_total_naira

required

Vat Total Naira

string

/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/

total_naira

required

Total Naira

string

/^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$/

customer_external_id

Any of:

string

string

null

null

pasca_dispatch_id

Any of:

string

string

null

null

Examples

Example Sample response

200 response example

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "external_id": "string",
  "status": "draft",
  "invoice_number": "string",
  "irn": "string",
  "currency": "string",
  "issue_date": "2026-02-11",
  "due_date": "2026-02-11",
  "subtotal_naira": "100.00",
  "vat_total_naira": "100.00",
  "total_naira": "100.00",
  "customer_external_id": "string",
  "pasca_dispatch_id": "string"
}

422

Validation Error

Media type application/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Examples

Example Sample response

422 response example

{
  "detail": [
    {
      "loc": [],
      "msg": "string",
      "type": "string"
    }
  ]
}