---
title: "Endpoint para consultar los eventos asociados a una factura hasta la fecha"
method: GET
path: "/events/invoice/{cufe}"
tags: ["Eventos electrónicos"]
---

# Endpoint para consultar los eventos asociados a una factura hasta la fecha

`GET /events/invoice/{cufe}`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/events/invoice/{cufe}`
- Auth: HTTP bearer

Devuelve un objeto JSON donde se muestra la información relacionada a cada evento asociado

## Path parameters

- `cufe` string, required

## Query parameters

- `xmlbase64` string

## Response `200`

Objeto que muestra las posibles respuestas de la API cuando se consultan los eventos asociados a una factura electrónica

- object
  - `isValid` boolean: Indica la validez de la factura electrónica
  - `errorMessages` string[]: Lista de mensajes de error
  - `statusCode` string: Código regresado por la DIAN
  - `statusDescription` string: Significado del código regresado por la DIAN
  - `events` object[]: Eventos asociados a la factura electrónica
    - `responseCode` string: Código del evento
    - `type` string: Descripción del tipo de evento
    - `effectiveTime` string: Fecha y hora de emisión del evento
    - `documentReference` object
      - `number` string: Número del evento emitido
      - `uuid` string: CUDE asociado al evento.
    - `issuerParty` object
      - `identificationNumber` string: Número de identificación del emisor del evento
      - `name` string: Nombre o razón social del emisor del evento
    - `receiverParty` object
      - `identificationNumber` string: Número de identificación del receptor del evento
      - `name` string: Nombre o razón social del receptor del evento
  - `xmlBase64` string: Documento xml obtenido como respuesta de la DIAN, se regresa en base64 y únicamente cuando se indica en la url [?xmlbase64=true] como un query param

## 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
- `503`: Objecto que representa una respuesta de error cuando ha ocurrido un error de comunicación con la DIAN

---

[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)