---
title: "List bills"
method: GET
path: "/v1/bills"
tags: ["Bills"]
---

# List bills

`GET /v1/bills`

## Request

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

Bills the organization received, newest first (created_at, then id).

## Query parameters

- `limit` string
- `cursor` string
- `status` 'draft' | 'received' | 'paid' | 'cancelled' | 'overdue' | 'scheduled'
- `due_from` string: Earliest due date, inclusive (UTC).
- `due_to` string: Latest due date, inclusive (UTC).
- `issued_from` string: Earliest issue date, inclusive (UTC). Documents without an issue date are not matched.
- `issued_to` string: Latest issue date, inclusive (UTC). Documents without an issue date are not matched.

## Response `200`

OK

- object
  - `data` object[], required
    - `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
  - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page; null when this is the last page.

## 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).
- `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)