---
title: "Listar personas receptoras"
method: GET
path: "/receivers-for-stamp-documents"
tags: ["Recepción de comprobantes"]
---

# Listar personas receptoras

`GET /receivers-for-stamp-documents`

## Request

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

Consulta las personas receptoras de comprobantes registradas para Colombia.

## Query parameters

- `limit` integer
- `fields` string[]
- `receiverType` ReceiverType (unresolved $ref)

## Parameters

- `#/paths/~1stamp-documents-received/get/parameters/0` (unresolved $ref)
- `#/paths/~1stamp-documents-received/get/parameters/3` (unresolved $ref)

## Response `200`

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

- union
  - Receiver[]
    - `identificationType` 'NIT' | 'CC' | 'DIE' | 'PP' | 'CE' | 'TE' | 'TI' | 'RC' | 'FOREIGN_NIT' | 'NUIP' | 'PEP' | 'PPT', required: Tipo de documento de identificación de la persona receptora admitido en Colombia, como CC (cédula de ciudadanía) o NIT.
    - `identification` string, required: Número de identificación de la persona receptora.
    - `firstName` string, required: Primer nombre de la persona receptora.
    - `secondName` string, nullable: Segundo nombre de la persona receptora si lo tiene.
    - `lastName` string, required: Apellido de la persona receptora.
    - `receiverRole` string, nullable: Cargo de la persona receptora.
    - `receiverArea` string, nullable: Área en la que trabaja la persona receptora.
    - `receiverType` 'ACKNOWLEDGMENT' | 'SERVICE_CONFIRMATION' | 'ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION': Tipo de persona receptora. Usa ACKNOWLEDGMENT para acuse de recibo, SERVICE_CONFIRMATION para recibo de bienes o servicios, o ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION para ambos.
    - `preferred` 0 | 1
    - `idGlobal` string, uuid: Se incluye al solicitar fields=idGlobal.
    - `createdAt` string: Se incluye al solicitar fields=createdAt.
    - `updatedAt` string: Se incluye al solicitar fields=updatedAt.
  - object
    - `metadata` object, required
      - `total` integer
    - `data` Receiver[], required
      - `identificationType` 'NIT' | 'CC' | 'DIE' | 'PP' | 'CE' | 'TE' | 'TI' | 'RC' | 'FOREIGN_NIT' | 'NUIP' | 'PEP' | 'PPT', required: Tipo de documento de identificación de la persona receptora admitido en Colombia, como CC (cédula de ciudadanía) o NIT.
      - `identification` string, required: Número de identificación de la persona receptora.
      - `firstName` string, required: Primer nombre de la persona receptora.
      - `secondName` string, nullable: Segundo nombre de la persona receptora si lo tiene.
      - `lastName` string, required: Apellido de la persona receptora.
      - `receiverRole` string, nullable: Cargo de la persona receptora.
      - `receiverArea` string, nullable: Área en la que trabaja la persona receptora.
      - `receiverType` 'ACKNOWLEDGMENT' | 'SERVICE_CONFIRMATION' | 'ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION': Tipo de persona receptora. Usa ACKNOWLEDGMENT para acuse de recibo, SERVICE_CONFIRMATION para recibo de bienes o servicios, o ACKNOWLEDGMENT_AND_SERVICE_CONFIRMATION para ambos.
      - `preferred` 0 | 1
      - `idGlobal` string, uuid: Se incluye al solicitar fields=idGlobal.
      - `createdAt` string: Se incluye al solicitar fields=createdAt.
      - `updatedAt` string: Se incluye al solicitar fields=updatedAt.

## Other responses

- `400` (unresolved $ref)

---

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