---
title: "Consultar os detalhes de uma conta escrow"
method: GET
path: "/escrow/api/v1/accounts/{account_id}"
tags: ["Contas"]
---

# Consultar os detalhes de uma conta escrow

`GET /escrow/api/v1/accounts/{account_id}`

## Request

- Base URL: `https://sandbox.platform.credit.celcoin.com.br`
- URL: `https://sandbox.platform.credit.celcoin.com.br/escrow/api/v1/accounts/{account_id}`
- Auth: none declared

Esse endpoint é responsável por retornar os dados de uma conta escrow, retornando todos os dados que foram recepcionados do envio, como o número da conta, status atualizado, usuário responsável pelo cadastro, dados da Pessoa titular da conta. Tenha acesso aos detalhes de todas as transações, lançamentos, tarifas, lançamentos futuros e solicitações de transações

#### Parâmetros da URL

- `account_id` (string): ID de cadastro para identificação da conta a ser consultada.
    

#### Resposta

Se a requisição for processada com sucesso será retornado um código 200 e um JSON no seguinte formato:

- `id` (string): ID para identificação da conta escrow.
    
- `status` (string): Status do conta. Possíveis valores: CREATING, ERROR_CREATING, PENDING_ACTIVATION, ACTIVE, BLOCKING, ERROR_BLOCKING, UNBLOCKING, ERROR_UNBLOCKING, BLOCKED, CANCELING, ERROR_CANCELING, CANCELED, WAITING_ANALYSIS, IN_ANALYSIS, WAITING_UPDATES.
    
- `account` (string): Número da conta.
    
- `branch` (string): Número da agência.
    
- `error` (string): Retorno em caso de algum erro na geração da conta.
    
- `fees` (object): Objeto contendo os dados das tarifas associadas a conta.
    
- `person` (object): Objeto contendo os dados da Pessoa.
    
- `destinations` (object): Objeto contendo os dados das contas bancárias cadastrads para transações.
    

##### Objeto 'Person'

- `person -> id` (string): ID de cadastro da Pessoa.
    
- `person -> name` (string): Nome da Pessoa
    
- `person -> taxpayerId` (string): Número do CPF da Pessoa
    
- `person -> emailAddress` (string): E-mail de contato.
    
- `person -> birthDate` (string): Data de nascimento, caso o titular seja uma pessoa física.
    
- `person -> phone` (object): Objeto contendo os dados do telefone para contato.
    
- `person -> personType` (string): Tipo da Pessoa. Possíveis valores: LEGAL, NATURAL.
    
- `person -> address` (object): Objeto contendo detalhes do endereço de cadastro.
    
- `person -> representatives` (object): Objeto contendo os dados dos sócios, caso o titular da conta seja uma pessoa jurídica.
    
- `person -> creator` (object): Objeto contendo os dados de quem fez o cadastro da conta.
    
- `person -> documents` (object): Objeto contendo os dados dos documentos anexados na conta.
    
- `corporateName` (string): Razão social da empresa, caso o titular da conta seja uma pessoa jurídica.
    
- `foundationDate` (datetime): Data de abertura da empresa, caso o titular da conta seja uma pessoa jurídica.
    
- `cnae` (string): Código do CNAE referente a atividade principal da empresa, caso o titular da conta seja uma pessoa jurídica.
    

##### Objeto 'address'

- `streetNumber` (string): Número do endereço informado.
    
- `streetName` (string): Nome da rua.
    
- `postalCode` (string): Código de CEP para o endereço.
    
- `district` (string): Campo para informar o bairro.
    
- `city` (string): Nome da cidade.
    
- `stateCode` (string): Código da UF para o estado do endereço.
    
- `countryCode` (string): Código do país.
    
- `extraInfo` (string): Complemento.
    

##### Objeto 'phone'

- `phone -> countryCode` (string): Código DDI do país.
    
- `phone -> areaCode` (string): Código DDD da área.
    
- `phone -> number` (string): Número de telefone.
    

##### Objeto 'documents'

- `documents -> incorporationCertificateUrl` (string): Endereço web (URL) do contrato social de constituição da empresa.
    
- `documents -> proofOfAddressUrl` (string): Endereço web (URL) do documento de comprovante de residência.
    
- `documents -> bylawsUrl` (string): Endereço web (URL) do estatuto societário da empresa.
    
- `documents -> powerOfAttorneyUrl` (string): Endereço web (URL) de uma procuração.
    
- `documents -> incomeStatementUrl` (string): Endereço web (URL) do comprovante de renda.
    
- `documents -> lastContractAmendmentUrl` (string): Endereço web (URL) da última alteração contratual.
    
- `documents -> identificationUrl` (string): Endereço web (URL) do comprovante de identidade.
    

##### Objeto 'creator'

- `creator -> id` (string): ID de cadastro.
    
- `creator -> fullname` (string): Nome completo.
    
- `creator -> taxpayerId` (string): Número do CPF.
    
- `createdAt` (datetime): Data da criação da conta.
    

##### Objeto 'representatives' (Se titular for do tipo uma pessoa jurídica, 'LEGAL')

- `role` (string): Função ou cargo do representante. Valores aceitos: MANAGER
    
- `taxpayerId` (string): Número do CPF do representante.
    
- `fullName` (string): Nome completo.
    
- `motherName` (string): Nome da mãe, conforme registro e documento de identidade.
    
- `emailAddress` (string): E-mail principal de contato.
    
- `birthDate` (datetime): Data de nascimento.
    
- `signContract` (boolean): Flag para indicar se o representante possui poderes para assinar pela empresa.
    
- `representatives -> phone` (object): Objeto contendo os dados do telefone para contato do representante.
    
- `representatives -> address` (object): Objeto contendo detalhes do endereço de cadastro do representante.
    
- `representatives -> documents` (object): Objeto contendo os dados dos documentos comprobatórios do sócio.
    

##### Objeto 'fees'

- `mode` (string): Forma de cobrança das tarifas. Possíveis valores: DIRECT_DEBIT.
    
- `defaultPaymentType` (string): Forma de pagamento para cobrança das tarifas. Possíveis valores: PIX, TED.
    
- `maintenance` (object): Objeto com os dados tarifa de manutenção da conta.
    
- `maintenance -> day` (integer): Dia do mês que será feita a cobrança.
    
- `maintenance -> amount` (float): Valor a ser cobrado pela tarifa.
    
- `deposit -> amount` (float): Valor da tarifa para depósitos.
    
- `withdrawal -> amount` (float): Valor da tarifa para saques.
    
- `tedTransfer -> amount` (float): Valor da tarifa para transferências por TED.
    
- `tedDeposit -> amount` (float): Valor da tarifa para depósitos por TED.
    

##### Objeto 'destinations'

- `id` (string): ID de cadastro da conta de destino.
    
- `taxpayerId` (string): Número do CPF ou CNPJ do titular da conta.
    
- `name` (string): Nome completo do titular da conta.
    
- `bank` (string): Código de identificação do banco.
    
- `branch` (string): Número da agência.
    
- `account` (string): Número da conta bancária.
    
- `type` (string): Tipo da conta a ser cadastrada.
    

##### Exemplo de JSON:

``` json
{
    "id": "<string>",
    "status": "ACTIVE",
    "personId": "<string>",
    "documents": {
        "openingAgreement": "<string>"
    },
    "person": {
        "taxpayerId": "<string>",
        "name": "<string>",
        "emailAddress": "<email>",
        "phone": {
            "countryCode": "+860",
            "areaCode": "<string>",
            "number": "<string>"
        },
        "address": {
            "streetName": "<string>",
            "streetNumber": "<string>",
            "postalCode": "20547430",
            "district": "<string>",
            "city": "<string>",
            "stateCode": "<string>",
            "countryCode": "<string>",
            "extraInfo": "<string>"
        },
        "personType": "LEGAL",
        "documents": {
            "incorporationCertificateUrl": "<string>",
            "proofOfAddressUrl": "<string>",
            "bylawsUrl": "<string>",
            "powerOfAttorneyUrl": "<string>",
            "incomeStatementUrl": "<string>",
            "lastContractAmendmentUrl": "<string>",
            "identificationUrl": "<string>"
        },
        "representatives": [
            {
                "role": "MANAGER",
                "taxpayerId": "<string>",
                "fullName": "<string>",
                "motherName": "<string>",
                "emailAddress": "<string>",
                "birthDate": "<string>",
                "phone": {
                    "countryCode": "+8",
                    "areaCode": "<string>",
                    "number": "<string>"
                },
                "address": {
                    "streetName": "<string>",
                    "streetNumber": "<string>",
                    "postalCode": "44019726",
                    "district": "<string>",
                    "city": "<string>",
                    "stateCode": "<string>",
                    "countryCode": "<string>",
                    "extraInfo": "<string>"
                },
                "documents": {
                    "identificationUrl": "<string>",
                    "proofOfAddressUrl": "<string>"
                },
                "signContract": "<boolean>",
                "representative": {
                    "taxpayerId": "<string>",
                    "fullName": "<string>",
                    "motherName": "<string>",
                    "emailAddress": "<string>",
                    "birthDate": "<string>",
                    "phone": {
                        "countryCode": "+1",
                        "areaCode": "<string>",
                        "number": "<string>"
                    },
                    "address": {
                        "streetName": "<string>",
                        "streetNumber": "<string>",
                        "postalCode": "73044278",
                        "district": "<string>",
                        "city": "<string>",
                        "stateCode": "<string>",
                        "countryCode": "<string>",
                        "extraInfo": "<string>"
                    },
                    "documents": {
                        "identificationUrl": "<string>",
                        "proofOfAddressUrl": "<string>"
                    },
                    "signContract": "<boolean>"
                }
            },
            {
                "role": "MANAGING_PARTNER",
                "taxpayerId": "<string>",
                "fullName": "<string>",
                "motherName": "<string>",
                "emailAddress": "<string>",
                "birthDate": "<string>",
                "phone": {
                    "countryCode": "+2",
                    "areaCode": "<string>",
                    "number": "<string>"
                },
                "address": {
                    "streetName": "<string>",
                    "streetNumber": "<string>",
                    "postalCode": "74113438",
                    "district": "<string>",
                    "city": "<string>",
                    "stateCode": "<string>",
                    "countryCode": "<string>",
                    "extraInfo": "<string>"
                },
                "documents": {
                    "identificationUrl": "<string>",
                    "proofOfAddressUrl": "<string>"
                },
                "signContract": "<boolean>",
                "representative": {
                    "taxpayerId": "<string>",
                    "fullName": "<string>",
                    "motherName": "<string>",
                    "emailAddress": "<string>",
                    "birthDate": "<string>",
                    "phone": {
                        "countryCode": "+1",
                        "areaCode": "<string>",
                        "number": "<string>"
                    },
                    "address": {
                        "streetName": "<string>",
                        "streetNumber": "<string>",
                        "postalCode": "49674137",
                        "district": "<string>",
                        "city": "<string>",
                        "stateCode": "<string>",
                        "countryCode": "<string>",
                        "extraInfo": "<string>"
                    },
                    "documents": {
                        "identificationUrl": "<string>",
                        "proofOfAddressUrl": "<string>"
                    },
                    "signContract": "<boolean>"
                }
            }
        ],
        "corporateName": "<string>",
        "foundationDate": "<string>",
        "birthDate": "<string>",
        "cnae": "<string>"
    },
    "parties": [
        {
            "id": "<string>",
            "person": {
                "id": "<uuid>",
                "businessType": "CONSULTANT",
                "name": "<string>",
                "taxpayerId": "<string>",
                "representatives": [
                    {
                        "taxpayerId": "<string>",
                        "fullName": "<string>",
                        "signContract": "<boolean>",
                        "representative": {
                            "taxpayerId": "<string>",
                            "fullName": "<string>",
                            "signContract": "<boolean>"
                        }
                    },
                    {
                        "taxpayerId": "<string>",
                        "fullName": "<string>",
                        "signContract": "<boolean>",
                        "representative": {
                            "taxpayerId": "<string>",
                            "fullName": "<string>",
                            "signContract": "<boolean>"
                        }
                    }
                ],
                "corporateName": "<string>"
            },
            "signContract": "<boolean>",
            "permissions": [
                "CREATE_CHARGE",
                "VIEW_ACCOUNT"
            ]
        },
        {
            "id": "<string>",
            "person": {
                "id": "<uuid>",
                "businessType": "CONSULTANT",
                "name": "<string>",
                "taxpayerId": "<string>",
                "representatives": [
                    {
                        "taxpayerId": "<string>",
                        "fullName": "<string>",
                        "signContract": "<boolean>",
                        "representative": {
                            "taxpayerId": "<string>",
                            "fullName": "<string>",
                            "signContract": "<boolean>"
                        }
                    },
                    {
                        "taxpayerId": "<string>",
                        "fullName": "<string>",
                        "signContract": "<boolean>",
                        "representative": {
                            "taxpayerId": "<string>",
                            "fullName": "<string>",
                            "signContract": "<boolean>"
                        }
                    }
                ],
                "corporateName": "<string>"
            },
            "signContract": "<boolean>",
            "permissions": [
                "POSTING_CREATE",
                "CANCEL_CHARGE"
            ]
        }
    ],
    "destinations": [
        {
            "id": "<string>",
            "taxpayerId": "<string>",
            "name": "<string>",
            "bank": "<string>",
            "branch": "<string>",
            "account": "<string>",
            "type": "<string>"
        },
        {
            "id": "<string>",
            "taxpayerId": "<string>",
            "name": "<string>",
            "bank": "<string>",
            "branch": "<string>",
            "account": "<string>",
            "type": "<string>"
        }
    ],
    "branch": "<string>",
    "account": "<string>",
    "error": "<string>",
    "fees": {
        "mode": "DIRECT_DEBIT",
        "defaultPaymentType": "PIX",
        "maintenance": {
            "day": "<integer>",
            "amount": "<number>"
        },
        "deposit": {
            "amount": "<number>"
        },
        "withdrawal": {
            "amount": "<number>"
        },
        "tedTransfer": {
            "amount": "<number>"
        },
        "tedDeposit": {
            "amount": "<number>"
        }
    }
}

 ```

## Path parameters

- `account_id` string, required

## Headers

- `Accept` string

## Response `200`

OK

- object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/celcoin/apis/celcoin-escrow.md) - [All operations](https://skmtc.dev/celcoin/apis/celcoin-escrow/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/celcoin-escrow/revisions/5d55a35a6d51?raw)