--- title: "Consulta do registro da empresa" method: GET path: "/business/{documentNumber}" tags: ["Pessoa jurídica"] --- # Consulta do registro da empresa `GET /business/{documentNumber}` ## Request - Base URL: `https://api-mtls.sandbox.bankly.com.br` - URL: `https://api-mtls.sandbox.bankly.com.br/business/{documentNumber}` - Auth: HTTP bearer

Obtenha um resultado resumido (BASIC) ou detalhado (DETAILED) dos dados de registro de uma empresa.

stable scope: business.read
[block:callout] { "type": "info", "title": "Nota", "body": "Para mais informações, confira a documentação [Consulta do registro da empresa](/docs/consulta-registro-empresa)." } [/block] ## Query parameters - `resultLevel` 'BASIC' | 'DETAILED': Tipo de retorno da API. _(BASIC, DETAILED)_ ## Parameters - `#/paths/~1business~1{documentNumber}/put/parameters/0` (unresolved $ref) - `#/paths/~1business~1{documentNumber}/put/parameters/1` (unresolved $ref) - `#/paths/~1business~1{documentNumber}/put/parameters/2` (unresolved $ref) ## Response `200` Recurso encontrado. - BusinessResponse - `documentNumber` string: Número do documento CNPJ da empresa. (Obsoleto. Considere o campo document.value). - `document` object: Objeto que contém informações sobre o documento da pessoa jurídica. - `value` string: Número do documento. - `type` string: Tipo do documento (nesse caso, "CNPJ"). - `businessName` string: Razão social da empresa. - `tradingName` string: Nome fantasia da empresa. - `businessEmail` string, email: E-mail comercial da empresa. - `businessType` 'MEI' | 'EI' | 'EIRELI' | 'SLU' | 'LTDA' | 'SA' | 'TS': Tipo da empresa. - `businessSize` 'MEI' | 'ME' | 'EPP' | 'SMALL' | 'MEDIUM' | 'LARGE': Porte da empresa. - `businessAddress` AddressResponse - `zipCode` string: O CEP correspondente ao endereço. - `addressLine` string: Logradouro (Nome da rua, avenida etc.). - `buildingNumber` string: Número da residência. - `complement` string, nullable: Complemento do endereço. Exemplo: Apto 123, Casa B etc. - `neighborhood` string: Nome do bairro ou distrito. - `city` string: Nome da cidade. - `state` string: Sigla do estado brasileiro conforme a ISO 3166-2:BR. - `country` string: Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR. - `status` 'PENDING_APPROVAL' | 'APPROVED' | 'IN_ANALYSIS' | 'REPROVED' | 'REVOKED' | 'CANCELED' | 'BLACKLISTED': Status da análise KYC realizada no registro do cliente. - `declaredAnnualBilling` 'UP_TO_FIFTY_THOUSAND' | 'MORE_THAN_FIFTY_THOUSAND_UP_TO_ONE_HUNDRED_THOUSAND' | 'MORE_THAN_ONE_HUNDRED_THOUSAND_UP_TO_TWO_HUNDRED_AND_FIFTY_THOUSAND' | 'MORE_THAN_TWO_HUNDRED_AND_FIFTY_THOUSAND_UP_TO_FIVE_HUNDRED_THOUSAND' | 'MORE_THAN_FIVE_HUNDRED_THOUSAND_UP_TO_ONE_MILLION' | 'MORE_THAN_ONE_MILLION_UP_TO_TWO_MILLION_AND_FIVE_HUNDRED_THOUSAND' | 'MORE_THAN_TWO_MILLION_AND_FIVE_HUNDRED_THOUSAND_UP_TO_FIVE_MILLION' | 'MORE_THAN_FIVE_MILLION_UP_TO_TEN_MILLION' | 'MORE_THAN_TEN_MILLION_UP_TO_TWENTY_FIVE_MILLION' | 'MORE_THAN_TWENTY_FIVE_MILLION_UP_TO_FIFTY_MILLION' | 'MORE_THAN_FIFTY_MILLION_UP_TO_ONE_HUNDRED_MILLION' | 'MORE_THAN_ONE_HUNDRED_MILLION_UP_TO_TWO_HUNDRED_AND_FIFTY_MILLION' | 'MORE_THAN_TWO_HUNDRED_AND_FIFTY_MILLION_UP_TO_FIVE_HUNDRED_MILLION' | 'MORE_THAN_FIVE_HUNDRED_MILLION' | 'EXEMPT_COMPANY' | 'NOT_DECLARED' | 'INACTIVE_COMPANY': Faixa de faturamento anual da empresa. - `confirmedAnnualBilling` string: Indica se o valor de faturamento informado foi confirmado no Bureau de informação. - `owners` LegalRepresentativeBusinessResponse[]: Lista de sócios da empresa como consta no Quadro dos Sócios e Administradores (QSA). Somente retornado para clientes do tipo LTDA, S.A. e TS. - `documentNumber` string: Número do documento CPF do cliente. (Obsoleto. Considere o campo document.value). - `document` object: Objeto que contém informações sobre o documento do cliente. - `value` string: Número do documento. - `type` string: Tipo do documento (CPF). - `registerName` string: Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) do representante legal. - `socialName` string, nullable: Nome pelo qual a pessoa gostaria de ser chamada. Para saber mais, consulte a [Cartilha do nome social](https://www.mds.gov.br/webarquivos/publicacao/assistencia_social/Folders/cartilha_nome_social.pdf). - `phone` PhoneResponse - `countryCode` string: Código DDI do país. - `number` string: Número de telefone incluindo DDD. - `address` AddressResponse - `zipCode` string: O CEP correspondente ao endereço. - `addressLine` string: Logradouro (Nome da rua, avenida etc.). - `buildingNumber` string: Número da residência. - `complement` string, nullable: Complemento do endereço. Exemplo: Apto 123, Casa B etc. - `neighborhood` string: Nome do bairro ou distrito. - `city` string: Nome da cidade. - `state` string: Sigla do estado brasileiro conforme a ISO 3166-2:BR. - `country` string: Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR. - `birthDate` string, date-time: Data de nascimento do cliente, no formato ISO 8601 - UTC. O representante legal deve possuir no mínimo **18 anos**. - `motherName` string, nullable: Nome da mãe do proprietário ou representante legal conforme consta no documento de identificação. - `email` string, email: Endereço de e-mail. Um mesmo endereço de e-mail não poderá ser usado por dois clientes. - `participationPercentage` string, nullable: Percentual de participação (0 a 100). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `tradingName` string, nullable: Nome fantasia da empresa (apenas para sócio pessoa jurídica). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `businessName` string, nullable: Razão social da empresa (apenas para sócio pessoa jurídica). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `businessType` 'MEI' | 'EI' | 'EIRELI' | 'SLU' | 'LTDA' | 'SA' | 'TS': Tipo da empresa. - `declaredIncome` 'LESS_THAN_ONE_THOUSAND' | 'FROM_ONE_THOUSAND_TO_TWO_THOUSAND' | 'FROM_TWO_THOUSAND_TO_THREE_THOUSAND' | 'FROM_THREE_THOUSAND_TO_FIVE_THOUSAND' | 'FROM_FIVE_THOUSAND_TO_TEN_THOUSAND' | 'FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND' | 'OVER_TWENTY_THOUSAND': Faixa de renda declarada pelo cliente. Campo obsoleto em produção a partir do dia 27/11/2023. Deve ser substituído pelo objeto assertedIncome. - `confirmedIncome` string: Indica se o valor informado da renda foi confirmado no Bureau de informação. O valor padrão desse campo é null. - `occupation` 'OCP0001' | 'OCP0002' | 'OCP0003' | 'OCP0004' | 'OCP0005' | 'OCP0006' | 'OCP0007' | 'OCP0008' | 'OCP0009' | 'OCP0010' | 'OCP0011' | 'OCP0012' | 'OCP0013' | 'OCP0014' | 'OCP0015' | 'OCP0016' | 'OCP0017' | 'OCP0018' | 'OCP0019' | 'OCP0020' | 'OCP0021' | 'OCP0022' | 'OCP0023' | 'OCP0024' | 'OCP0025' | 'OCP0026' | 'OCP0027' | 'OCP0028' | 'OCP0029' | 'OCP0030' | 'OCP0031' | 'OCP0032' | 'OCP0033' | 'OCP0034' | 'OCP0035' | 'OCP0036' | 'OCP0037' | 'OCP0038' | 'OCP0039' | 'OCP0040' | 'OCP0041' | 'OCP0042' | 'OCP0043' | 'OCP0044' | 'OCP0045' | 'OCP0046' | 'OCP0047' | 'OCP0048' | 'OCP0049' | 'OCP0050' | 'OCP0051' | 'OCP0052' | 'OCP0053' | 'OCP0054' | 'OCP0055' | 'OCP0056' | 'OCP0057' | 'OCP0058' | 'OCP0059' | 'OCP0060' | 'OCP0061' | 'OCP0062' | 'OCP0063' | 'OCP0064' | 'OCP0065' | 'OCP0066' | 'OCP0067' | 'OCP0068' | 'OCP0069' | 'OCP0070' | 'OCP0071' | 'OCP0072' | 'OCP0073' | 'OCP0074' | 'OCP0075' | 'OCP0076' | 'OCP0077' | 'OCP0078' | 'OCP0079' | 'OCP0080' | 'OCP0081' | 'OCP0082' | 'OCP0083' | 'OCP0084' | 'OCP0085' | 'OCP0086' | 'OCP0087' | 'OCP0088' | 'OCP0089' | 'OCP0090' | 'OCP0091' | 'OCP0092' | 'OCP0093' | 'OCP0094' | 'OCP0095' | 'OCP0096' | 'OCP0097' | 'OCP0098' | 'OCP0099' | 'OCP0100' | 'OCP0101' | 'OCP0102' | 'OCP0103' | 'OCP0104' | 'OCP0105': Código de ocupação do cliente. Para conhecer a descrição dos códigos das ocupações, consulte a documentação [Código de ocupação do cliente](https://docs.bankly.com.br/docs/codigo-de-ocupacao-cliente). - `pep` PepResponse: Objeto que informa o nível de exposição política do cliente, atendendo à Circular nº 3.978. - `level` 'NONE' | 'SELF' | 'RELATED': Nível de exposição política do cliente. - `verified` boolean: Indica se a situação de vínculo com pessoa politicamente exposta foi verificada no Bureau de informação. O valor default desse campo é false. - `documentation` SendedDocumentationResponse: Objeto que contém as informações referentes aos documentos enviados para análise. - `selfie` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `idCardFront` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `idCardBack` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `legalRepresentatives` object[], nullable: Representantes legais da empresa (apenas para sócio pessoa jurídica). Esse campo traz uma lista de itens com as mesmas propriedades do objeto pai legalRepresentative e retorna somente para clientes do tipo LTDA, S.A. e TS. - `owners` object[], nullable: Sócios da empresa (apenas para sócio pessoa jurídica). Esse campo traz uma lista de itens com as mesmas propriedades do objeto pai legalRepresentative e retorna somente para clientes do tipo LTDA, S.A. e TS. - `legalRepresentatives` LegalRepresentativeBusinessResponse[]: Lista de representantes legais da empresa. - `documentNumber` string: Número do documento CPF do cliente. (Obsoleto. Considere o campo document.value). - `document` object: Objeto que contém informações sobre o documento do cliente. - `value` string: Número do documento. - `type` string: Tipo do documento (CPF). - `registerName` string: Nome conforme consta no documento de identificação (RG, CNH, RNE, DNI ou CRNM) do representante legal. - `socialName` string, nullable: Nome pelo qual a pessoa gostaria de ser chamada. Para saber mais, consulte a [Cartilha do nome social](https://www.mds.gov.br/webarquivos/publicacao/assistencia_social/Folders/cartilha_nome_social.pdf). - `phone` PhoneResponse - `countryCode` string: Código DDI do país. - `number` string: Número de telefone incluindo DDD. - `address` AddressResponse - `zipCode` string: O CEP correspondente ao endereço. - `addressLine` string: Logradouro (Nome da rua, avenida etc.). - `buildingNumber` string: Número da residência. - `complement` string, nullable: Complemento do endereço. Exemplo: Apto 123, Casa B etc. - `neighborhood` string: Nome do bairro ou distrito. - `city` string: Nome da cidade. - `state` string: Sigla do estado brasileiro conforme a ISO 3166-2:BR. - `country` string: Sigla do país (Brasil) conforme a ISO 3166-2. Exemplo: BR. - `birthDate` string, date-time: Data de nascimento do cliente, no formato ISO 8601 - UTC. O representante legal deve possuir no mínimo **18 anos**. - `motherName` string, nullable: Nome da mãe do proprietário ou representante legal conforme consta no documento de identificação. - `email` string, email: Endereço de e-mail. Um mesmo endereço de e-mail não poderá ser usado por dois clientes. - `participationPercentage` string, nullable: Percentual de participação (0 a 100). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `tradingName` string, nullable: Nome fantasia da empresa (apenas para sócio pessoa jurídica). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `businessName` string, nullable: Razão social da empresa (apenas para sócio pessoa jurídica). Campo retornado somente para clientes do tipo LTDA, S.A. e TS. - `businessType` 'MEI' | 'EI' | 'EIRELI' | 'SLU' | 'LTDA' | 'SA' | 'TS': Tipo da empresa. - `declaredIncome` 'LESS_THAN_ONE_THOUSAND' | 'FROM_ONE_THOUSAND_TO_TWO_THOUSAND' | 'FROM_TWO_THOUSAND_TO_THREE_THOUSAND' | 'FROM_THREE_THOUSAND_TO_FIVE_THOUSAND' | 'FROM_FIVE_THOUSAND_TO_TEN_THOUSAND' | 'FROM_TEN_THOUSAND_TO_TWENTY_THOUSAND' | 'OVER_TWENTY_THOUSAND': Faixa de renda declarada pelo cliente. Campo obsoleto em produção a partir do dia 27/11/2023. Deve ser substituído pelo objeto assertedIncome. - `confirmedIncome` string: Indica se o valor informado da renda foi confirmado no Bureau de informação. O valor padrão desse campo é null. - `occupation` 'OCP0001' | 'OCP0002' | 'OCP0003' | 'OCP0004' | 'OCP0005' | 'OCP0006' | 'OCP0007' | 'OCP0008' | 'OCP0009' | 'OCP0010' | 'OCP0011' | 'OCP0012' | 'OCP0013' | 'OCP0014' | 'OCP0015' | 'OCP0016' | 'OCP0017' | 'OCP0018' | 'OCP0019' | 'OCP0020' | 'OCP0021' | 'OCP0022' | 'OCP0023' | 'OCP0024' | 'OCP0025' | 'OCP0026' | 'OCP0027' | 'OCP0028' | 'OCP0029' | 'OCP0030' | 'OCP0031' | 'OCP0032' | 'OCP0033' | 'OCP0034' | 'OCP0035' | 'OCP0036' | 'OCP0037' | 'OCP0038' | 'OCP0039' | 'OCP0040' | 'OCP0041' | 'OCP0042' | 'OCP0043' | 'OCP0044' | 'OCP0045' | 'OCP0046' | 'OCP0047' | 'OCP0048' | 'OCP0049' | 'OCP0050' | 'OCP0051' | 'OCP0052' | 'OCP0053' | 'OCP0054' | 'OCP0055' | 'OCP0056' | 'OCP0057' | 'OCP0058' | 'OCP0059' | 'OCP0060' | 'OCP0061' | 'OCP0062' | 'OCP0063' | 'OCP0064' | 'OCP0065' | 'OCP0066' | 'OCP0067' | 'OCP0068' | 'OCP0069' | 'OCP0070' | 'OCP0071' | 'OCP0072' | 'OCP0073' | 'OCP0074' | 'OCP0075' | 'OCP0076' | 'OCP0077' | 'OCP0078' | 'OCP0079' | 'OCP0080' | 'OCP0081' | 'OCP0082' | 'OCP0083' | 'OCP0084' | 'OCP0085' | 'OCP0086' | 'OCP0087' | 'OCP0088' | 'OCP0089' | 'OCP0090' | 'OCP0091' | 'OCP0092' | 'OCP0093' | 'OCP0094' | 'OCP0095' | 'OCP0096' | 'OCP0097' | 'OCP0098' | 'OCP0099' | 'OCP0100' | 'OCP0101' | 'OCP0102' | 'OCP0103' | 'OCP0104' | 'OCP0105': Código de ocupação do cliente. Para conhecer a descrição dos códigos das ocupações, consulte a documentação [Código de ocupação do cliente](https://docs.bankly.com.br/docs/codigo-de-ocupacao-cliente). - `pep` PepResponse: Objeto que informa o nível de exposição política do cliente, atendendo à Circular nº 3.978. - `level` 'NONE' | 'SELF' | 'RELATED': Nível de exposição política do cliente. - `verified` boolean: Indica se a situação de vínculo com pessoa politicamente exposta foi verificada no Bureau de informação. O valor default desse campo é false. - `documentation` SendedDocumentationResponse: Objeto que contém as informações referentes aos documentos enviados para análise. - `selfie` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `idCardFront` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `idCardBack` string: Token retornado no endpoint de [Envio e análise de documentos pessoais com ID One](https://docs.bankly.com.br/docs/envio-documentos-analise-id-one). - `legalRepresentatives` object[], nullable: Representantes legais da empresa (apenas para sócio pessoa jurídica). Esse campo traz uma lista de itens com as mesmas propriedades do objeto pai legalRepresentative e retorna somente para clientes do tipo LTDA, S.A. e TS. - `owners` object[], nullable: Sócios da empresa (apenas para sócio pessoa jurídica). Esse campo traz uma lista de itens com as mesmas propriedades do objeto pai legalRepresentative e retorna somente para clientes do tipo LTDA, S.A. e TS. - `createdAt` string, date-time: Data do primeiro registro da empresa. - `updatedAt` string, date-time, nullable: Data da atualização do registro da empresa. - `cnaeCode` string, nullable: Código CNAE (Classificação Nacional de Atividades Econômicas) da empresa. Somente retornado para clientes do tipo LTDA, S.A. e TS. - `legalNature` string, nullable: Natureza jurídica da empresa. Somente retornado para clientes do tipo LTDA, S.A. e TS. - `openingDate` string, date-time: Data de abertura da empresa. Somente retornado para clientes do tipo LTDA, S.A. e TS. - `phone` PhoneResponse - `countryCode` string: Código DDI do país. - `number` string: Número de telefone incluindo DDD. - `reasons` string[], nullable: Motivos de reprovação do registro da empresa (quando é o caso). ## Other responses - `400` (unresolved $ref) - `403` (unresolved $ref) - `404`: Recurso não encontrado. - `500` (unresolved $ref) --- [API](https://skmtc.dev/bankly/apis/registro-do-cliente.md) - [All operations](https://skmtc.dev/bankly/apis/registro-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/registro-do-cliente/revisions/8062de128aa6?raw)