---
title: "Consulta API Beneficiário Final"
method: POST
path: "/beneficiariofinalendrs"
tags: ["API Beneficiário Final"]
---

# Consulta API Beneficiário Final

`POST /beneficiariofinalendrs`

Esta API retorna os beneficiários finais associados a um CNPJ,
incluindo dados cadastrais, endereço residencial ou comercial, faixa
de renda estimada e status na Receita Federal de cada beneficiário
identificado.

## TABELA DE CAMPOS DE REQUISIÇÃO

| Campo | Descrição | Formato | Obrigatório |
|-------|-----------|---------|-------------|
| IdConsulta | Identificador da consulta. Valor fixo: 635. | string | Sim |
| CpfCnpj | CNPJ da empresa a ser consultada. | string | Sim |

## TABELA DE CAMPOS DE RETORNO

| Campo | Descrição | Formato |
|-------|-----------|---------|
| CONSULTA.CODIGORESPOSTA | Código interno da transação. | string |
| CONSULTA.DATAHORA | Data e hora da consulta. | DD/MM/YYYY HH:MM:SS |
| CONSULTA.LOGON | Identificador da conta que realizou a consulta. | string |
| CONSULTA.IDCONSULTA | IdConsulta enviado na requisição. | string |
| RESPOSTA.CODIGO | Código do resultado: 1 sucesso, 2 não encontrado, 3 erro. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.CNPJ | CNPJ da empresa consultada. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.TIPO_DOCUMENTO | Tipo de documento do beneficiário (F = física, J = jurídica). | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.RAZAO_SOCIAL | Razão social da empresa consultada. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.CPF | CPF do beneficiário final. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.NOME | Nome completo do beneficiário final. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.TP_ENDERECO | Tipo de endereço (RESIDENCIAL ou COMERCIAL). | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.TP_LOGRADOURO | Tipo de logradouro (ex: RUA, AV). | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.LOGRADOURO | Nome do logradouro. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.NUMERO | Número do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.COMPLEMENTO | Complemento do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.BAIRRO | Bairro do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.CIDADE | Cidade do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.UF | UF do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.CEP | CEP do endereço. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.FAIXA_RENDA_ESTIMADA | Faixa de renda estimada do beneficiário. | string |
| RESPOSTA.BENEFICIARIO_FINAL.REGISTRO_N.STATUS_RECEITA | Situação cadastral do beneficiário na Receita Federal. | string |

## Request body

- object
  - `Consulta` object
    - `IdConsulta` string, required
    - `CpfCnpj` string, required

## Response `200`

Resposta da consulta.
- Código 1: Sucesso.
- Código 2: Registro não encontrado.
- Código 3: Erro na consulta.

- object
  - `CONSULTA` object
    - `CODIGORESPOSTA` string
    - `DATAHORA` string
    - `LOGON` string
    - `IDCONSULTA` string
  - `RESPOSTA` object
    - `CODIGO` string
    - `BENEFICIARIO_FINAL` object
      - `REGISTRO_1` object
        - `CNPJ` string
        - `TIPO_DOCUMENTO` string
        - `RAZAO_SOCIAL` string
        - `CPF` string
        - `NOME` string
        - `TP_ENDERECO` string
        - `TP_LOGRADOURO` string
        - `LOGRADOURO` string
        - `NUMERO` string
        - `COMPLEMENTO` string
        - `BAIRRO` string
        - `CIDADE` string
        - `UF` string
        - `CEP` string
        - `FAIXA_RENDA_ESTIMADA` string
        - `STATUS_RECEITA` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/credify/apis/credify-api-auth.md) · [All operations](https://skmtc.net/credify/apis/credify-api-auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/credify/credify-api-auth/revisions/c8c11484ec88/schema)