---
title: "List all Invoices"
method: GET
path: "/api/v1/invoices"
tags: ["Invoices"]
---

# List all Invoices

`GET /api/v1/invoices`

Permissions needed: VIEW_INVOICES_CASHING
Returns list of Invoices

## Query parameters

- `filter[pet_id]` integer
- `filter[sale_id]` integer
- `filter[series]` string
- `filter[number]` integer
- `filter[updated_from]` string, date-time
- `filter[updated_to]` string, date-time
- `sort` string
- `include` string
- `detailed` boolean

## Parameters

- `#/paths/~1api~1v1~1pets/get/parameters/0` — unresolved $ref
- `#/paths/~1api~1v1~1pets/get/parameters/2` — unresolved $ref
- `#/paths/~1api~1v1~1tags/get/parameters/5` — unresolved $ref

## Response `200`

successful operation

- object
  - `data` union[]
    - union
      - object
        - `id` integer
        - `clinic_id` string
        - `sale_id` string
        - `series` string
        - `date` string
        - `number` string
        - `total` string
        - `created_at` string
        - `updated_at` string
        - `series_no` string
        - `sale` Data — unresolved $ref
      - object — A more detailed version of the Invoice which contains information about the products and services that were sold as well as a more debunked version of the totals involved in the sale.
        - `id` integer
        - `clinic_id` string
        - `sale_id` string
        - `series` string
        - `date` string
        - `number` string
        - `created_at` string
        - `updated_at` string
        - `series_no` string
        - `sale` Data — unresolved $ref
        - `vet` Items — unresolved $ref
        - `generalDiscount` string — same as global_discount
        - `global_discount` string — same as generalDiscount
        - `total` string
        - `subtotal` string
        - `amount_due` string
        - `vat` string — Deprecated alias of `tax_amount`. A tax amount, not a percentage. Use `tax_amount` instead.
        - `tax_amount` string
        - `hide_details` boolean
        - `hide_total` boolean
        - `totalDiscount` string — same as items_discount
        - `items_discount` string — same as totalDiscount
        - `products` object[]
          - `name` string
          - `discount` string
          - `discount_value` string
          - `discount_type` 0 | 1 — `0` - fixed `1` - percentage
          - `subtotalWithDiscount` string
          - `vat` string — Deprecated. Use `effective_tax_percentage` instead.
          - `effective_tax_percentage` number, float — Tax percentage applied to the line, summed from its tax rates.
          - `category` string
          - `unit` string
          - `quantity` string
          - `unitPrice` string
          - `subtotalPrice` string
          - `vatValue` string
          - `totalPrice` string
        - `services` object[]
          - `name` string
          - `quantity` string
          - `discount` string
          - `discount_value` string
          - `discount_type` 0 | 1 — `0` - fixed `1` - percentage
          - `subtotalWithDiscount` string
          - `vat` string — Deprecated. Use `effective_tax_percentage` instead.
          - `effective_tax_percentage` number, float — Tax percentage applied to the line, summed from its tax rates.
          - `unitPrice` string
          - `subtotalPrice` string
          - `vatValue` string
          - `totalPrice` string
          - `visibleProducts` object[]
  - `links` Links — unresolved $ref
  - `meta` Meta — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref

---

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