Skip to main content
GET
/
api
/
invoices
Listar registros de facturación con filtros
curl --request GET \
  --url https://api.kubifactu.com/api/invoices \
  --header 'X-Qbikode-ClientApiKey: <api-key>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "client_invoice_id": "<string>",
      "record_type": "creation",
      "request_id": "2cc8ef846029ec69613711ad1d85f6dfebf16ffb",
      "fiscal_year": 2025,
      "full_invoice_number": "F23-0000123",
      "issue_date": "2025-09-15",
      "created_at": "2025-09-15T07:35:24.992854Z",
      "fingerprint": "<string>",
      "csv": "<string>",
      "vf_post_status": "success",
      "vf_record_registration_status": "success",
      "has_warnings": false,
      "vf_error_descriptions": "<string>"
    }
  ],
  "meta": {
    "per_page": 50,
    "next_page_cursor": "eyJpZCI6IjE5NzctMDQtMjJUMDY6MDA6MDBaIn0",
    "prev_page_cursor": "ffN6eRJ0i2YPRA7C51eYNkLt8HIubpW9RDrFk77",
    "has_more": true
  }
}

Authorizations

​
X-Qbikode-ClientApiKey
string
header
required

API-KEY de la empresa que hace la petición. Este dato se puede consultar en el panel web, accediendo a la sección Empresas y accediendo a la ficha de la empresa en.

Query Parameters

​
date_from
string<date>
required

Fecha de inicio del rango de creación de las facturas (incluida). Formato YYYY-MM-DD.

Example:

"2025-01-01"

​
date_to
string<date>
required

Fecha de fin del rango de creación de las facturas (incluida). Debe ser igual o posterior a date_from.

Example:

"2025-01-31"

​
sif_id
string

ID del SIF emisor sobre el que se quieren buscar registros de facturación.

Example:

"A3DEAECE-8698-4E3D-A0A3-A17B523B9703"

​
vf_post_status
string

Filtrar registros de facturación por el estado de envío a Veri*Factu.

Ver valores posibles para vf_post_status en la respuesta de envío de registros de facturación.

Example:

"failure"

​
vf_record_registration_status
string

Filtrar registros de facturación por el estado del registro reportado por Veri*Factu.

Ver valores posibles para vf_record_registration_status en la respuesta de envío de registros de facturación.

Example:

"accepted_with_errors"

​
per_page
integer

Número de elementos por página (máximo 50). Valor por defecto 50.

Required range: 1 <= x <= 50
Example:

25

​
cursor
string

Cursor para la paginación basada en cursor. Use el valor devuelto en meta.next_page_cursor.

Example:

"eyJpZCI6IjE5NzctMDQtMjJUMDY6MDA6MDBaIn0"

Response

Listado paginado de registros de facturación.

​
data
object[]
​
meta
object
⌘I