---
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}`

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.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)