Skip to content
Vai integrar a API REST da Zarv com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar a API REST da Zarv. Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/api/id-v3/datasets/company-profile-2-0
- Autenticação Bearer JWT e hosts: https://developers.zarv.com/setup
- Índice das APIs: https://developers.zarv.com/api
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

Os specs OpenAPI publicados são a fonte da verdade para rotas e schemas — use o spec da API que você escolher antes de escrever qualquer request.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: escolher a API certa e fazer a primeira chamada autenticada]

profile 2.0 · Empresa ​

Cadastro de um CNPJ na Receita Federal: existencia, nomes, situacao cadastral e seu motivo, natureza juridica, capital declarado, atividades e historico de mudancas. Mais os telefones, e-mails e enderecos associados ao CNPJ, com quantos outros documentos usam cada um.

EntidadeEmpresa (CNPJ, entity: pj)
Móduloprofile
Versão2.0 (mais recente)
Datasetcompany-profile-2.0
ExecuçãoSempre roda: é o módulo que localiza o titular

Este é o formato do corpo de GET /api/v3/enrichments/{id}/modules/profile, a rota que a url do módulo, na raiz do enriquecimento, aponta. Os campos são publicados como o dataset os entrega: um campo ausente significa que o dado não foi obtido, não que o valor é falso ou zero. Os caminhos abaixo são relativos ao corpo da resposta.

Envelope ​

CampoTipoObservação
datasetstringsempre company-profile-2.0
modulestringsempre profile
profileobjectos dados do módulo (abaixo)

Dados ​

identification ​

CampoTipoObservação
profile.existsboolean
profile.officialNamestring
profile.tradeNamestring
profile.foundedAtstringdate
profile.isHeadquarterboolean
profile.headquarterStatestring
profile.isConglomerateboolean
profile.aliases.officialNamestring
profile.aliases.tradeNamestring
profile.uniqueness.namenumber
profile.uniqueness.officialNamenumber
profile.uniqueness.tradeNamenumber

taxStatus ​

CampoTipoObservação
profile.taxId.numberstring
profile.taxId.statusstring
profile.taxId.statusReasonstring
profile.taxId.statusDatestringdate
profile.taxId.registrationDatestringdate
profile.taxId.originstring
profile.taxId.countrystring
profile.taxId.regimestring
profile.taxId.companyTypestring
profile.taxId.simplesOptantboolean
profile.specialSituationstring

constitution ​

CampoTipoObservação
profile.legalNature.codestring
profile.legalNature.activitystring
profile.capital.valuenumber
profile.capital.descriptionstring
profile.registration.nirestring
profile.registration.headquartersCapitalnumber
profile.registration.lastCaptureDatestringdate

activities ​

CampoTipoObservação
profile.activitiesarray<object>
profile.activities[].activitystring
profile.activities[].classstring
profile.activities[].codestring
profile.activities[].divisionstring
profile.activities[].groupstring
profile.activities[].isMainboolean

foreignTrade ​

CampoTipoObservação
profile.foreignTrade.codestring
profile.foreignTrade.lastUpdatestringdate

history ​

CampoTipoObservação
profile.history.tradeNameChangedboolean
profile.history.taxRegimeChangedboolean
profile.history.tradeNamearray<object>
profile.history.tradeName[].endDatestringdate
profile.history.tradeName[].startDatestringdate
profile.history.tradeName[].valuestring
profile.history.taxRegimearray<object>
profile.history.taxRegime[].endDatestringdate
profile.history.taxRegime[].startDatestringdate
profile.history.taxRegime[].valuestring

record ​

CampoTipoObservação
profile.record.createdAtstringdate
profile.record.updatedAtstringdate

contactAddresses ​

CampoTipoObservação
profile.contacts.addresses.oldestPassageAtstringdate
profile.contacts.addresses.newestPassageAtstringdate
profile.contacts.addresses.itemsarray<object>
profile.contacts.addresses.items[].activeboolean
profile.contacts.addresses.items[].citystring
profile.contacts.addresses.items[].complementstring
profile.contacts.addresses.items[].countrystring
profile.contacts.addresses.items[].entitiesAtAddressinteger
profile.contacts.addresses.items[].firstSeenAtstringdate
profile.contacts.addresses.items[].lastSeenAtstringdate
profile.contacts.addresses.items[].likelyAccountantboolean
profile.contacts.addresses.items[].mainboolean
profile.contacts.addresses.items[].mainForOtherEntityboolean
profile.contacts.addresses.items[].neighborhoodstring
profile.contacts.addresses.items[].numberstring
profile.contacts.addresses.items[].officialboolean
profile.contacts.addresses.items[].statestring
profile.contacts.addresses.items[].streetstring
profile.contacts.addresses.items[].typestring
profile.contacts.addresses.items[].zipCodestring

contactPhones ​

CampoTipoObservação
profile.contacts.phones.oldestPassageAtstringdate
profile.contacts.phones.newestPassageAtstringdate
profile.contacts.phones.itemsarray<object>
profile.contacts.phones.items[].activeboolean
profile.contacts.phones.items[].areaCodestring
profile.contacts.phones.items[].carrierstring
profile.contacts.phones.items[].countryCodestring
profile.contacts.phones.items[].doNotCallboolean
profile.contacts.phones.items[].entitiesWithPhoneinteger
profile.contacts.phones.items[].firstSeenAtstringdate
profile.contacts.phones.items[].lastSeenAtstringdate
profile.contacts.phones.items[].likelyAccountantboolean
profile.contacts.phones.items[].mainboolean
profile.contacts.phones.items[].mainForOtherEntityboolean
profile.contacts.phones.items[].numberstring
profile.contacts.phones.items[].officialboolean
profile.contacts.phones.items[].planTypestring
profile.contacts.phones.items[].typestring

contactEmails ​

CampoTipoObservação
profile.contacts.emails.oldestPassageAtstringdate
profile.contacts.emails.newestPassageAtstringdate
profile.contacts.emails.itemsarray<object>
profile.contacts.emails.items[].activeboolean
profile.contacts.emails.items[].addressstring
profile.contacts.emails.items[].domainstring
profile.contacts.emails.items[].entitiesWithEmailinteger
profile.contacts.emails.items[].firstSeenAtstringdate
profile.contacts.emails.items[].lastSeenAtstringdate
profile.contacts.emails.items[].likelyAccountantboolean
profile.contacts.emails.items[].mainboolean
profile.contacts.emails.items[].mainForOtherEntityboolean
profile.contacts.emails.items[].officialboolean
profile.contacts.emails.items[].typestring
profile.contacts.emails.items[].validationStatusstring

timeline ​

CampoTipoObservação
profile.timelinearray<object>
profile.timeline[].amountBrlnumber
profile.timeline[].basisstring
profile.timeline[].datestring
profile.timeline[].detailstring
profile.timeline[].eventstring
profile.timeline[].precisionstring
profile.timeline[].refstring
profile.timeline[].sourcestring