---
title: "Get Invoice"
method: GET
path: "/api/invoices/{invoice_id}"
tags: ["invoices"]
---

# Get Invoice

`GET /api/invoices/{invoice_id}`

## Request

- Base URL: `https://demo.usesecuro.com` (the document declares no server; this is the origin it was published from)
- URL: `https://demo.usesecuro.com/api/invoices/{invoice_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`
- TypeScript: <https://skmtc.dev/usesecuro/apis/securo/docs/api/invoices/:invoice_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `invoice_id` string, uuid, required

## Headers

- `X-Workspace-Id` string, nullable

## Response `200`

Successful Response

- InvoiceRead
  - `id` string, uuid, required
  - `payee_id` string, uuid, nullable, required
  - `payee` InvoicePayee
    - `id` string, uuid, required
    - `name` string, required
  - `document_type` string, required
  - `direction` 'receivable' | 'payable', required
  - `origin` string, required
  - `external_source` string, nullable
  - `external_id` string, nullable
  - `number` integer, nullable, required
  - `series` string, nullable, required
  - `external_number` string, nullable
  - `status` 'draft' | 'open' | 'void' | 'uncollectible', required
  - `state` 'draft' | 'open' | 'partial' | 'paid' | 'overdue' | 'void' | 'uncollectible'
  - `issue_date` string, date, required
  - `due_date` string, date, required
  - `competence_date` string, date, nullable, required
  - `sent_at` string, date-time, nullable, required
  - `currency` string, required
  - `subtotal` string, required
  - `discount` string, required
  - `tax_total` string, required
  - `total` string, required
  - `amount_paid` string
  - `amount_deducted` string
  - `balance` string
  - `days_overdue` integer
  - `next_due_date` string, date, nullable
  - `notes` string, nullable, required
  - `internal_notes` string, nullable, required
  - `custom_fields` object, nullable, required
  - `snapshot` object, nullable, required
  - `share_token` string, nullable
  - `schedule_id` string, uuid, nullable
  - `schedule` InvoiceScheduleRef: Just enough of the agreement to label the invoice with it.
    - `id` string, uuid, required
    - `name` string, required
    - `frequency` string, required
    - `status` string, required
  - `sequence` integer, nullable
  - `period_start` string, date, nullable
  - `period_end` string, date, nullable
  - `lines` InvoiceLineRead[]
    - `id` string, uuid, required
    - `product_id` string, uuid, nullable
    - `price_id` string, uuid, nullable
    - `fiscal_refs` object, nullable
    - `description` string, required
    - `quantity` string, required
    - `unit` string, nullable
    - `unit_price` string, required
    - `tax_rate` string, nullable, required
    - `total` string, required
    - `position` integer, required
  - `allocations` InvoiceAllocationRead[]
    - `id` string, uuid, required
    - `transaction_id` string, uuid, nullable, required
    - `credit_note_id` string, uuid, nullable, required
    - `amount` string, required
    - `method` string, required
    - `allocated_at` string, date-time, required
    - `transaction` AllocationTransaction: Just enough of the transaction to render the row it came from.
      - `id` string, uuid, required
      - `description` string, nullable
      - `date` string, date, nullable
      - `amount` string, nullable
  - `installments` InstallmentRead[]
    - `id` string, uuid, required
    - `position` integer, required
    - `label` string, nullable
    - `due_date` string, date, required
    - `amount` string, required
    - `settled` string
    - `state` string
  - `deductions` InvoiceDeductionRead[]
    - `id` string, uuid, required
    - `kind` 'withholding_tax' | 'gateway_fee' | 'fx_difference' | 'other', required
    - `tax_kind` string, nullable
    - `amount` string, required
    - `note` string, nullable
    - `transaction_id` string, uuid, nullable
    - `deducted_at` string, date-time, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `416a7752fec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usesecuro/apis/securo/changes/api/invoices/:invoice_id/get.md)

---

[API](https://skmtc.dev/usesecuro/apis/securo.md) - [All operations](https://skmtc.dev/usesecuro/apis/securo/llms.txt) - [OpenAPI document](https://skmtc.dev/usesecuro/apis/securo/revisions/416a7752fec4?raw)