---
title: "Listar comprobantes recibidos"
method: GET
path: "/stamp-documents-received"
tags: ["Recepción de comprobantes"]
---

# Listar comprobantes recibidos

`GET /stamp-documents-received`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/stamp-documents-received`
- Auth: HTTP basic

Consulta los comprobantes del buzón de recepción para Colombia.

## Query parameters

- `start` integer
- `limit` integer
- `order_direction` 'ASC' | 'DESC'
- `metadata` boolean
- `fields` string[]
- `identification` string
- `provider_name` string
- `total` string
- `response` string[]
- `query` string
- `number` string
- `date_laterThanOrEqualTo` string, date
- `date_earlierThanOrEqualTo` string, date
- `is_registered` boolean

## Response `200`

Lista de comprobantes recibidos. Con metadata=true devuelve data con la página y metadata.total con el total de coincidencias antes de paginar.

- union
  - StampDocumentReceived[]
    - `id` string: Identificador local del comprobante
    - `number` string, nullable
    - `date` string, date, nullable: Fecha de expedición del comprobante.
    - `name` string, nullable
    - `identification` string, nullable
    - `total` string, nullable
    - `response` string, nullable
    - `origin` string, nullable
    - `resourceType` string, nullable
    - `address` string, nullable
    - `idResource` string, nullable: Identificador del documento registrado asociado.
    - `datetime` string: Fecha y hora de registro del comprobante en Alegra.
    - `uuid` string, nullable: Identificador electrónico del comprobante (CUFE).
    - `responseNumber` integer, nullable
    - `prefix` string, nullable
    - `legalStatus` string, nullable
    - `accusedId` string, nullable: Identificador del acuse de recibo.
    - `confirmationId` string, nullable
    - `rejectionConcept` string, nullable
    - `paymentForm` 'CASH' | 'CREDIT', nullable
    - `responseHistory` object, nullable: Fechas de los eventos enviados, con formato YYYY-MM-DD HH:mm:ss.
    - `responseStatus` object, nullable: Estado de cada evento. Consulta este campo para verificar su procesamiento.
    - `importedStatus` object, nullable: Indica por evento si su estado fue importado.
    - `currency` object
      - `name` string
      - `code` string, nullable
      - `symbol` string, nullable
      - `exchangeRate` number, nullable
      - `status` string, nullable
      - `main` boolean
    - `stampReceptionEmail` object, nullable: Se incluye al solicitar fields=stampReceptionEmail; puede ser null si no hay un correo asociado.
      - `id` string
      - `from` object
        - `name` string, nullable
        - `address` string
      - `to` object
        - `address` string
      - `subject` string, nullable
      - `message` string, nullable
      - `datetime` string
  - object
    - `metadata` object, required
      - `total` integer
    - `data` StampDocumentReceived[], required
      - `id` string: Identificador local del comprobante
      - `number` string, nullable
      - `date` string, date, nullable: Fecha de expedición del comprobante.
      - `name` string, nullable
      - `identification` string, nullable
      - `total` string, nullable
      - `response` string, nullable
      - `origin` string, nullable
      - `resourceType` string, nullable
      - `address` string, nullable
      - `idResource` string, nullable: Identificador del documento registrado asociado.
      - `datetime` string: Fecha y hora de registro del comprobante en Alegra.
      - `uuid` string, nullable: Identificador electrónico del comprobante (CUFE).
      - `responseNumber` integer, nullable
      - `prefix` string, nullable
      - `legalStatus` string, nullable
      - `accusedId` string, nullable: Identificador del acuse de recibo.
      - `confirmationId` string, nullable
      - `rejectionConcept` string, nullable
      - `paymentForm` 'CASH' | 'CREDIT', nullable
      - `responseHistory` object, nullable: Fechas de los eventos enviados, con formato YYYY-MM-DD HH:mm:ss.
      - `responseStatus` object, nullable: Estado de cada evento. Consulta este campo para verificar su procesamiento.
      - `importedStatus` object, nullable: Indica por evento si su estado fue importado.
      - `currency` object
        - `name` string
        - `code` string, nullable
        - `symbol` string, nullable
        - `exchangeRate` number, nullable
        - `status` string, nullable
        - `main` boolean
      - `stampReceptionEmail` object, nullable: Se incluye al solicitar fields=stampReceptionEmail; puede ser null si no hay un correo asociado.
        - `id` string
        - `from` object
          - `name` string, nullable
          - `address` string
        - `to` object
          - `address` string
        - `subject` string, nullable
        - `message` string, nullable
        - `datetime` string

## Other responses

- `400`: Faltan datos obligatorios o la solicitud no es válida.

---

[API](https://skmtc.dev/alegra/apis/gastos.md) - [All operations](https://skmtc.dev/alegra/apis/gastos/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/gastos/revisions/0b1ed7b7581d?raw)