---
title: "List invoices"
method: GET
path: "/tabs/{storeId}/invoices"
---

# List invoices

`GET /tabs/{storeId}/invoices`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/tabs/{storeId}/invoices`
- Auth: none declared

## Path parameters

- `storeId` string, required

## Query parameters

- `fromDate` string, date-time: Fecha de inicio de la búsqueda.
- `toDate` string, date-time: Fecha de fin de la búsqueda.
- `page` number: Número de página.
- `limit` number: Número de items por página. Max 100. Por defecto: 10.
- `sortBy` 'createdAt': Campo por el cual se ordenará la lista. Por defecto: "createdAt".
- `sortType` 'asc' | 'desc': Tipo de ordenamiento.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object
    - `items` TabsTabInvoice[]: Items de la lista.
      - `_id` string: El ID de la factura.
      - `providerId` string: El ID del proveedor al que pertenece la factura.
      - `storeId` string: El ID del local asociado al documento tributario.
      - `tabId` string: El ID de la cuenta PDV asociada al documento, si existe.
      - `inventorySaleId` string: El ID de la venta de inventario asociada al documento, si existe.
      - `createdAt` string, date-time: Fecha de creación de la factura.
      - `generatedAt` string, date-time: Fecha de generación de la factura.
      - `status` 'pending' | 'generated' | 'error' | 'voided' | 'generating': El estado de la factura. Valores posibles: 'pending', 'generated', 'error', 'voided', 'generating'.
      - `externalInvoiceId` string: El ID de la factura en el sistema externo.
      - `externalVoidInvoiceId` string: El ID de la anulación en el sistema externo, si existe.
      - `errorMessage` string: Mensaje de error al generar la factura.
      - `voidedAt` string, date-time: Fecha de anulación de la factura.
      - `statusLabel` string: Etiqueta del estado de la factura.
      - `invoiceURL` string: URL de la factura.
      - `totalAmount` number: El monto total de la factura.
      - `taxAmount` number: El monto de los impuestos de la factura.
      - `netAmount` number: El monto total neto de la factura.
    - `hasNextPage` boolean: Indica si hay una página siguiente.
    - `hasPreviousPage` boolean: Indica si hay una página anterior.
    - `totalPages` number: Total de páginas.
    - `totalCount` number: Total de items.

## Other responses

- `400`: Errors

## Changes

- **2026-06-02** `dd70866e9669`: 4 info
  - added the optional property `data/items/items/externalVoidInvoiceId` to the response with the `200` status
  - added the optional property `data/items/items/inventorySaleId` to the response with the `200` status
  - added the optional property `data/items/items/storeId` to the response with the `200` status
  - added the optional property `data/items/items/tabId` to the response with the `200` status
- **2026-05-19** `7a0a64e85a6d`: 1 warning
  - added the new `generating` enum value to the `data/items/items/status` response property for the response status `200`
- **2025-12-04** `2442e4776b0f`: 3 info
  - added the optional property `data/items/items/netAmount` to the response with the `200` status
  - added the optional property `data/items/items/taxAmount` to the response with the `200` status
  - added the optional property `data/items/items/totalAmount` to the response with the `200` status
- **2025-08-18** `bf1ae81aa046`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/tabs/:storeId/invoices/get.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)