---
title: "Retrieve a invoice"
method: GET
path: "/invoices/{id}"
tags: ["Invoices"]
---

# Retrieve a invoice

`GET /invoices/{id}`

Retrieve a invoice by its unique identifier for the authenticated team.

## Path parameters

- `id` string, required

## Response `200`

Retrieve a invoice by its unique identifier for the authenticated team.

- object — Invoice object
  - `id` string, uuid, required — Unique identifier for the invoice
  - `status` 'draft' | 'overdue' | 'paid' | 'unpaid' | 'canceled' | 'scheduled', required — Current status of the invoice
  - `dueDate` string, required — Due date of the invoice in ISO 8601 format
  - `issueDate` string, required — Issue date of the invoice in ISO 8601 format
  - `invoiceNumber` string — Invoice number as shown to the customer (auto-generated if not provided)
  - `amount` number, nullable, required — Total amount of the invoice, or null if not yet calculated
  - `currency` string, nullable, required — Currency code (ISO 4217) for the invoice amount
  - `customer` object, nullable, required — Customer details
    - `id` string, uuid, required — Unique identifier for the customer
    - `name` string, required — Name of the customer
    - `website` string, nullable, required — Website URL of the customer
    - `email` string, email, nullable, required — Email address of the customer
  - `paidAt` string, nullable, required — Timestamp when the invoice was paid (ISO 8601), or null if unpaid
  - `reminderSentAt` string, nullable, required — Timestamp when a payment reminder was sent (ISO 8601), or null if never sent
  - `note` string, nullable, required — Optional note attached to the invoice
  - `vat` number, nullable, required — Value-added tax amount, or null if not applicable
  - `tax` number, nullable, required — Tax amount, or null if not applicable
  - `discount` number, nullable, required — Discount amount applied to the invoice, or null if none
  - `subtotal` number, nullable, required — Subtotal before taxes and discounts, or null if not calculated
  - `viewedAt` string, nullable, required — Timestamp when the invoice was viewed by the customer (ISO 8601), or null if never viewed
  - `customerName` string, nullable, required — Name of the customer as shown on the invoice, or null if not set
  - `sentTo` string, email, nullable, required — Email address to which the invoice was sent, or null if not sent
  - `sentAt` string, nullable, required — Timestamp when the invoice was sent (ISO 8601), or null if not sent
  - `createdAt` string, required — Timestamp when the invoice was created (ISO 8601)
  - `updatedAt` string, required — Timestamp when the invoice was last updated (ISO 8601)
  - `pdfUrl` string, uri, nullable, required — URL to download the invoice PDF, or null if not generated
  - `previewUrl` string, uri, nullable, required — URL to preview the invoice in the browser, or null if not generated

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)