---
title: "Obtém os dados de relacionamento da pessoa jurídica com a instituição"
method: GET
path: "/baas/v1/open/dat/customers/business/financial-relations"
tags: ["Customers | Dados"]
---

# Obtém os dados de relacionamento da pessoa jurídica com a instituição

`GET /baas/v1/open/dat/customers/business/financial-relations`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v1/open/dat/customers/business/financial-relations`
- Auth: HTTP bearer

Método para obter registros de relacionamentos com a instituição financeira e de representantes da pessoa jurídica mantidos na instituição transmissora.

PERMISSÃO NECESSÁRIA: `CUSTOMERS_BUSINESS_ADITTIONALINFO_READ`

## Query parameters

- `page` integer
- `page-size` integer

## Response `200`

Dados de relacionamento da pessoa jurídica obtidos com sucesso

- object
  - `data` object[], required
    - `updateDateTime` string, date-time, required: Data e hora da atualização dos campos
    - `businessId` string, required: Identificador único da pessoa jurídica
    - `brandName` string, required: Nome da Marca reportada pelo participante
    - `companiesCnpj` string[], required: CNPJ da instituição responsável
    - `startDate` string, date, required: Data de início de relacionamento com a Instituição Financeira
    - `productsServicesType` string[], required: Lista dos produtos e serviços com vínculo ativo
    - `procurators` object[]
      - `type` 'REPRESENTANTE_LEGAL' | 'PROCURADOR', required: Tipo de representação
      - `cpfNumber` string, required: CPF do representante
      - `civilName` string, required: Nome civil completo
      - `socialName` string, required: Nome social
    - `accounts` object[]
      - `compeCode` string, required: Código identificador atribuído pelo Banco Central
      - `branchCode` string, required: Código da Agência detentora da conta
      - `number` string, required: Número da conta
      - `checkDigit` string, required: Dígito da conta
      - `type` 'CONTA_DEPOSITO_A_VISTA' | 'CONTA_POUPANCA' | 'CONTA_PAGAMENTO_PRE_PAGA', required: Tipo de conta
      - `subtype` 'INDIVIDUAL' | 'CONJUNTA_SIMPLES' | 'CONJUNTA_SOLIDARIA', required: Subtipo de conta
  - `links` Links, required: Referências para outros recursos da API requisitada
    - `self` string, uri, required: URI completo que gerou a resposta atual
    - `first` string, uri: URI da primeira página que originou essa lista de resultados
    - `prev` string, uri: URI da página anterior dessa lista de resultados
    - `next` string, uri: URI da próxima página dessa lista de resultados
    - `last` string, uri: URI da última página dessa lista de resultados
  - `meta` Meta, required: Meta informações referente à API requisitada
    - `totalRecords` integer, required: Número total de registros no resultado
    - `totalPages` integer, required: Número total de páginas no resultado
    - `requestDateTime` string, date-time, required: Data e hora da consulta, conforme especificação RFC-3339, formato UTC

## Other responses

- `400`: Requisição malformada
- `401`: Token inválido ou não autorizado
- `403`: Token tem escopo incorreto ou política de segurança violada
- `404`: Recurso não encontrado
- `429`: Muitas solicitações foram feitas dentro de um determinado período

---

[API](https://skmtc.dev/celcoin/apis/api-para-transa-es.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-transa-es/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-transa-es/revisions/85dd6188a37b?raw)
