# Get Invoice Status

**Method:** `GET`

**Path:** `/api/pay/v1/orders/{orderId}/invoice`

**Category:** International Payments

**Authentication:** Required

## Description

Retrieves the current invoice details and status for a given order.
Use this API to check the invoice status after creating an invoice (metadata capture)
and/or uploading the invoice file.

**Status progression:**
- `INVOICE_CAPTURED` → after Create Invoice (Step 1)
- `INVOICE_UPLOADED` → after Upload File (Step 2)
- `INVOICE_REJECTED` → if rejected by bank/payment partner

This API is specific to cross-border orders where invoice documentation is required for compliance.


## Path Parameters

- `orderId` (`string`) **required** — Order ID returned from Create Order API.

## Responses

- `200` — Invoice status retrieved successfully.
- `400` — Validation error.
- `401` — 
- `404` — Invoice or order not found.
- `500` — 

### Response Schema

- `invoiceId` (`string`) — Unique invoice identifier.
- `orderId` (`string`) — Order ID associated with this invoice.
- `invoiceNumber` (`string`) — Invoice number provided during invoice creation.
- `invoiceDate` (`string`) — Invoice date in YYYY-MM-DD format.
- `supplierName` (`string`) — Supplier name (if provided during invoice creation).
- `status` (`INVOICE_CAPTURED | INVOICE_UPLOADED | INVOICE_REJECTED`) — Current invoice status.
- `createdAt` (`string`) — ISO 8601 timestamp of invoice creation.
- `updatedAt` (`string`) — ISO 8601 timestamp of last status update.

### Example Response

```json
{
  "invoiceId": "inv-260520225359-ab-XyZ123",
  "orderId": "v1-260520225359-aa-LHy288",
  "invoiceNumber": "v1-260520225359-aa-LHy288-IN",
  "invoiceDate": "2026-05-20",
  "supplierName": null,
  "status": "INVOICE_UPLOADED",
  "createdAt": "2026-05-20T22:53:59.000Z",
  "updatedAt": "2026-05-20T23:01:15.000Z"
}
```

---

Reference: https://localhost:3000/api/international-payments/get-invoice-status