---
title: "Consulta do beneficiário."
method: GET
path: "/beneficiary/{id}"
tags: ["Beneficiary"]
---

# Consulta do beneficiário.

`GET /beneficiary/{id}`

## Path parameters

- `id` string, required

## Response `200`

Success

- Beneficiary — Classe `Beneficiary` Modelo de beneficiário.
  - `id` string — Propriedade `Id` Identificador único gerado automaticamente.
  - `documentType` 'CNPJ' | 'CPF' | 'ESTRANGEIRO' — Tipo de Documento.<p>Values:</p><ul><li><i>CNPJ</i> - CNPJ.</li><li><i>CPF</i> - CPF.</li><li><i>ESTRANGEIRO</i> - Estrangeiro.</li></ul>
  - `document` string, nullable — Propriedade `Document` CPF ou CNPJ do beneficiário.
  - `name` string, nullable — Propriedade `Name` Nome ou Razão Social do beneficiário.
  - `status` 'APTO' | 'EM_ANALISE' | 'INAPTO' | 'SEM_CADASTRO' | 'PROCESSAMENTO' | 'REJEITADO' — Valores `BeneficiaryStatus` Situação do beneficiário.<p>Values:</p><ul><li><i>APTO</i> - Apto.</li><li><i>EM_ANALISE</i> - Em Análise.</li><li><i>INAPTO</i> - Inapto.</li><li><i>SEM_CADASTRO</i> - Sem Cadastro.</li><li><i>PROCESSAMENTO</i> - Processamento.</li><li><i>REJEITADO</i> - Rejeitado.</li></ul>
  - `created` string, date-time — Propriedade `Created` Data de inclusão.
  - `updated` string, date-time, nullable — Propriedade `Updated` Data de alteração.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Server Error

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)