---
title: "Endpoint para consultar el historial una factura electrónica"
method: GET
path: "/invoices/historial/{id}"
tags: ["Facturas de Venta electrónicas"]
---

# Endpoint para consultar el historial una factura electrónica

`GET /invoices/historial/{id}`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/invoices/historial/{id}`
- Auth: HTTP bearer

Retorna la información de las notas y eventos asociadas al `cufe` de la factura electrónica enviada como parámetro

## Path parameters

- `id` string, required

## Query parameters

- `type` 'cufe' | 'id'

## Response `200`

Objeto que representa la respuesta cuando se consulta el historial de una factura electrónica

- object
  - `notes` object: Notas asociados a la factura
    - `errors` string[]: Errores en la factura o notas asociados
    - `message` string: Mensaje de la nota
    - `data` object[]
      - `type` string: Tipo de nota
      - `fullNumber` string: Prefijo mas el número del nota
      - `cude` string: Código único de documento electrónico
      - `description` string: Descripción del nota
      - `date` string: Fecha y hora del nota
  - `events` object: Eventos asociados a la factura
    - `errors` string[]: Errores en la factura o eventos asociados
    - `message` string: Mensaje de la factura o eventos asociados
    - `data` object[]
      - `type` string: Tipo de evento
      - `fullNumber` string: Prefijo mas el número del evento
      - `cude` string: Código único de documento electrónico
      - `description` string: Descripción del evento
      - `date` string: Fecha y hora del evento

## Other responses

- `400`: Objeto que representa una respuesta de error por validaciones
- `404`: Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500`: Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)
