Skip to main content
GET
/
api
/
v1
/
invoices
List Invoices
curl --request GET \
  --url https://api.example.com/api/v1/invoices
{
  "data": [
    {
      "id": 123,
      "company_id": 123,
      "branch_id": 123,
      "client_id": 123,
      "tipo_documento": "<string>",
      "serie": "<string>",
      "correlativo": "<string>",
      "numero_completo": "<string>",
      "fecha_emision": "<string>",
      "moneda": "<string>",
      "mto_imp_venta": 123,
      "estado_sunat": "<string>",
      "sunat_respuesta": "<string>",
      "client": {},
      "company": {},
      "branch": {}
    }
  ],
  "current_page": 123,
  "per_page": 123,
  "total": 123,
  "last_page": 123
}
Retrieve a paginated list of invoices (facturas) for the authenticated user’s company.

​
Authentication

Requires a valid Bearer token with invoice viewing permissions. 
Authorization: Bearer YOUR_TOKEN_HERE

​
Query Parameters

​
page
integer
default:"1"
Page number for pagination
​
per_page
integer
default:"20"
Number of invoices per page (max 100)
​
company_id
integer
Filter by specific company ID
​
branch_id
integer
Filter by specific branch ID
​
client_id
integer
Filter by specific client ID
​
serie
string
Filter by document series (e.g., “F001”)
​
fecha_inicio
date
Start date filter (YYYY-MM-DD format)
​
fecha_fin
date
End date filter (YYYY-MM-DD format)
​
estado_sunat
string
Filter by SUNAT status: pendiente, aceptado, rechazado

​
Response

​
data
array
Array of invoice objects
​
current_page
integer
Current page number
​
per_page
integer
Items per page
​
total
integer
Total number of invoices matching the filters
​
last_page
integer
Last page number

​
Code Examples

curl -X GET "https://your-domain.com/api/v1/invoices?page=1&per_page=20&estado_sunat=aceptado" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Accept: application/json"

​
Response Example

{
  "data": [
    {
      "id": 123,
      "company_id": 1,
      "branch_id": 1,
      "client_id": 45,
      "tipo_documento": "01",
      "serie": "F001",
      "correlativo": "00000123",
      "numero_completo": "F001-00000123",
      "fecha_emision": "2025-03-05",
      "moneda": "PEN",
      "mto_imp_venta": 1180.00,
      "estado_sunat": "aceptado",
      "sunat_respuesta": "La Factura numero F001-00000123, ha sido aceptada",
      "client": {
        "id": 45,
        "nombre_comercial": "Cliente Ejemplo SAC",
        "numero_documento": "20123456789"
      },
      "company": {
        "id": 1,
        "nombre_comercial": "Mi Empresa SAC"
      },
      "created_at": "2025-03-05T10:30:00.000000Z"
    }
  ],
  "current_page": 1,
  "per_page": 20,
  "total": 156,
  "last_page": 8
}

​
Use Cases

  • Invoice Dashboard: Display all invoices with filtering and pagination
  • Reporting: Generate reports based on date ranges and status
  • Client History: View all invoices for a specific client
  • Accounting Integration: Export invoice data to accounting systems

Build docs developers (and LLMs) love

Get started for freeTalk to us