---
title: Get an invoice
description: Look up an invoice by your reference.
api: GET /invoices/{reference}
---

If it's still open, RazPay asks the provider once, and records it as paid (with its collection) if it has been.

- **`reference`** · path · `string` · required

  The invoice's `external_reference`.

## Response

An [invoice](/docs/api/create-invoice#the-invoice-object).

```json 200
{
  "success": true,
  "message": "",
  "data": {
    "external_reference": "fees-term2-0042",
    "provider_id": "momo",
    "provider_ref": "5d1e7a2b-9c3f-4e6a-8b0d-2f4c6e8a0b1d",
    "provider_invoice_id": "8810223",
    "payment_reference": "PR-77120",
    "amount": 1500,
    "currency": "SZL",
    "payer_phone": "26876123456",
    "description": "Term 2 school fees",
    "validity_seconds": 1209600,
    "status": "paid",
    "expires_at": 1761984000,
    "metadata": {},
    "created_at": 1760774400,
    "updated_at": 1761206400
  }
}
```

```json 404
{ "success": false, "message": "invoice not found", "data": null }
```