Retrieve an Invoice

GET /api/v1/invoices/:id

Retrieve a specific invoice by its ID, including full details such as line items, taxes, discounts, and customer information.

Path Parameters

Request Example

GET /api/v1/invoices/123 HTTP/1.1
Host: koteshen.com
Authorization: Bearer {access_token}
Content-Type: application/json
Accept: application/json

Response

Status Codes:

• 200 OK - Success.
• 401 Unauthorized - Invalid or missing token.
• 404 Not Found - Invoice not found.

Success Response (200)

{
  "data": {
    "id": 52,
    "number": "INV-9CAB-9664",
    "customer_id": 7,
    "business_id": 1,
    "currency": "USD",
    "due_at": "2025-08-28T00:00:00.000Z",
    "issued_at": "2025-08-28T00:00:00.000Z",
    "notes": "",
    "discount_type": "percent",
    "discount_value": null,
    "status": "created",
    "paid": true,
    "payment_term_id": null,
    "emailed_at": "2025-08-28T18:31:16.038Z",
    "created_at": "2025-08-28T17:52:02.164Z",
    "updated_at": "2025-10-18T00:23:06.963Z",
    "subtotal": {
      "cents": 400,
      "currency_iso": "USD"
    },
    "discount": {
      "cents": 0,
      "currency_iso": "USD"
    },
    "tax_total": 0,
    "total": {
      "cents": 400,
      "currency_iso": "USD"
    },
    "balance": {
      "cents": 200,
      "currency_iso": "USD"
    },
    "download_url": "<download_url>",
    "url": "http://localhost:3000/api/v1/invoices/52.json",
    "items": [
      {
        "id": 71,
        "name": "Web deisgn and dev",
        "unit_price": "400.0",
        "quantity": 1,
        "total": "400.0",
        "created_at": "2025-08-28T17:52:02.188Z",
        "updated_at": "2025-08-28T17:52:02.188Z"
      }
    ],
    "business": {
      "id": 1,
      "user_id": 1,
      "name": "Flixtechs",
      "slug": "flixtechs",
      "phone": "+27675711214",
      "phone_country": null,
      "discarded_at": null,
      "created_at": "2025-08-17T09:26:59.612Z",
      "updated_at": "2025-08-29T13:30:08.427Z",
      "address": {
        "id": 9,
        "line": "1 Mahem Place",
        "line2": "",
        "post_code": "5256",
        "city": "East London",
        "country": "ZA",
        "created_at": "2025-08-29T13:30:08.441Z",
        "updated_at": "2025-08-29T13:30:08.441Z"
      },
      "logo": "<logo_url>"
    },
    "customer": {
      "id": 7,
      "name": "Randall Rodrigo",
      "company": "Softbank",
      "customer_type": "individual",
      "phone": "+27675711214",
      "phone_country": "za",
      "currency": "USD",
      "email": "given@unspik.com",
      "website": "https://weldoge.co.zw",
      "business_id": 1,
      "notes": "",
      "created_at": "2025-08-27T20:34:43.872Z",
      "updated_at": "2025-09-24T22:35:10.418Z",
      "address": {
        "id": 8,
        "line": "1 Mahem Pl",
        "line2": "",
        "post_code": "5256",
        "city": "East London",
        "country": "ZA",
        "created_at": "2025-08-27T20:34:43.883Z",
        "updated_at": "2025-08-27T20:34:43.883Z"
      },
      "url": "http://localhost:3000/api/v1/customers/7.json"
    },
    "taxes": []
  }
}

Error Response Example (404)

{
  "errors": [
    {
      "detail": "Invoice not found"
    }
  ]
}