---
title: "Get a bill"
method: GET
path: "/v1/bills/{id}"
tags: ["Bills"]
---

# Get a bill

`GET /v1/bills/{id}`

## Request

- Base URL: `https://api.dynt.ai/v1/dynt-server.onrender.com`
- URL: `https://api.dynt.ai/v1/dynt-server.onrender.com/v1/bills/{id}`
- Auth: HTTP bearer

One bill.

## Path parameters

- `id` string, required: The resource id.

## Response `200`

OK

- object: A bill the organization received (payable).
  - `id` string, required
  - `number` string, required: Dynt's sequence number for the document.
  - `custom_id` string, nullable, required: The organization's own document number, when set.
  - `approval_status` string, required
  - `currency` string, required
  - `net_amount` string, required: Total before VAT.
  - `vat_amount` string, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
  - `total_amount` string, required: Total including VAT.
  - `eur_amount` string, nullable, required: Decimal amount as a string with the currency's own decimals (ISO 4217: 2 for EUR, 0 for JPY, 3 for BHD, 4 for CLF), e.g. "1234.50"; eur_amount always has 2.
  - `fx_rate` string, nullable, required: The stored exchange rate used for eur_amount, as a decimal string; null when none is stored.
  - `issue_date` string, date-time, nullable, required: RFC 3339 date-time in UTC.
  - `due_date` string, date-time, required: RFC 3339 date-time in UTC.
  - `category` object, nullable, required
    - `id` string, required
    - `name` string, required
  - `purchase_order_reference` string, nullable, required
  - `created_at` string, date-time, required: RFC 3339 date-time in UTC.
  - `updated_at` string, date-time, required: RFC 3339 date-time in UTC.
  - `proofs` object[], required
    - `id` string, required
    - `filename` string, required
    - `content_type` string, required
    - `size_bytes` integer, nullable, required: File size in bytes; null when unknown.
    - `created_at` string, date-time, required: When the file was attached.
  - `status` 'draft' | 'received' | 'paid' | 'cancelled' | 'overdue' | 'scheduled', required
  - `type_code` string, required: UNCL1001 document type: 380 invoice, 381 credit note.
  - `vendor` object, nullable, required
    - `id` string, required
    - `name` string, required
    - `tax_number` string, nullable, required
  - `seller_reference` string, nullable, required

## Other responses

- `400`: A parameter is invalid or unknown, or the request has a body (code bad_request).
- `401`: Missing, unknown, revoked or expired integration key (code unauthorized).
- `403`: The key lacks the read permission (code forbidden).
- `404`: No such resource in the key's organization (code not_found).
- `429`: Rate limited (code rate_limited).
- `500`: Internal error (code internal_error).
- `503`: Server busy; retry after the Retry-After delay (code server_busy).

---

[API](https://skmtc.dev/dynt/apis/dynt-api.md) · [All operations](https://skmtc.dev/dynt/apis/dynt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynt/apis/dynt-api/revisions/35825587b87b?raw)