{ "code": 400, "message": "Um ou mais parâmetros informados são inválidos."}
{ "code": 401, "message": "Credencial da API inválida."}
{ "code": 403, "message": "A credencial da API não possui permissão para este recurso."}
Executa uma busca paginada de pessoa jurídica a partir de um telefone com DDD.Use esta rota quando você possui um telefone e precisa localizar possíveis empresas relacionadas a ele.
Data de abertura ou início de atividade no formato yyyy-mm-dd, quando disponível.
Campos de items[] podem não ser retornados em todas as consultas. A disponibilidade depende do telefone informado e dos dados existentes para os registros encontrados.
Use x-ambient: sandbox para validar integração sem consumir saldo.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Lazy Data","description":"Lazy Data centraliza consultas, validações, enriquecimento de dados, monitoramento e armazenamento em uma plataforma segura para empresas que precisam tomar decisões com dados confiáveis.","colors":{"primary":"#7367F0","light":"#9B92FF","dark":"#5145CD"},"logo":{"light":"https://mintcdn.com/cyberxcorp/z2RS7RlTD1bZLQlu/images/lazy_data_logo_with_name_black.png?fit=max\u0026auto=format\u0026n=z2RS7RlTD1bZLQlu\u0026q=85\u0026s=f1d89b5299cdc7216b929e0c2852c6c9","dark":"https://mintcdn.com/cyberxcorp/z2RS7RlTD1bZLQlu/images/lazy_data_logo_with_name_white.png?fit=max\u0026auto=format\u0026n=z2RS7RlTD1bZLQlu\u0026q=85\u0026s=d240a969cab3b34d4a3bf8a74b564a90","href":"https://lazydata.com.br"},"favicon":{"light":"https://mintcdn.com/cyberxcorp/z2RS7RlTD1bZLQlu/images/lazydata_icon.ico?fit=max\u0026auto=format\u0026n=z2RS7RlTD1bZLQlu\u0026q=85\u0026s=b5e19fe20dd278dd2e8e44bd4f070403","dark":"https://mintcdn.com/cyberxcorp/z2RS7RlTD1bZLQlu/images/lazydata_icon.ico?fit=max\u0026auto=format\u0026n=z2RS7RlTD1bZLQlu\u0026q=85\u0026s=b5e19fe20dd278dd2e8e44bd4f070403"},"api":{"playground":{"display":"interactive","proxy":true},"examples":{"prefill":false,"autogenerate":true},"url":"full","mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://api.lazydata.com.br/"}},"navbar":{"links":[{"href":"mailto:support@lazydata.com.br","label":"Suporte"}],"primary":{"type":"button","label":"Painel","href":"https://app.lazydata.com.br"}},"footer":{"socials":{"instagram":"https://instagram.com/cyberxcorp_"}},"seo":{"metatags":{"title":"Lazy Data Docs","description":"Documentação oficial da Lazy Data para consultas, validações, enriquecimento, monitoramento, armazenamento e integrações via API.","keywords":"Lazy Data, documentação API, consulta CPF, consulta CNPJ, validação cadastral, enriquecimento de dados, monitoramento processual","author":"Lazy Data"},"indexing":"navigable"},"fonts":{"family":"Manrope"},"icons":{"library":"fontawesome"},"integrations":{"ga4":{"measurementId":"G-CKJMQ23MCX"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cyberxcorp","hasAudioNarration":false,"actualSubdomain":"cyberxcorp","customDomains":["docs.lazydata.com.br"],"gitSource":{"type":"github","owner":"cyberxcorpltda","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"17f7b25d-beab-4df6-b310-2409000b3264","liveDeploymentHistoryId":"6a4c62ed81f8fa22294e749c","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95aa634ab80277e3df9c4:success","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API reference","count":48},{"language":"default","tag":"Documentação","count":43},{"language":"default","tag":"Funcionalidades","count":25},{"language":"default","tag":"Consultas","count":19},{"language":"default","tag":"Monitoramento","count":19},{"language":"default","tag":"Enriquecimento","count":11},{"language":"default","tag":"Armazenamento","count":11},{"language":"default","tag":"Pessoa jurídica","count":7},{"language":"default","tag":"Pessoa física","count":7},{"language":"default","tag":"Utilidades","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/company/phone","slug":"/api-reference/company/phone","pageMetadata":{"title":"Busca por telefone","description":"Busque pessoas jurídicas vinculadas a um telefone com DDD.","sidebarTitle":"Busca por telefone","api":"POST /v1/search/company/phone","playground":"interactive","href":"/api-reference/company/phone"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Busque pessoas jurídicas vinculadas a um telefone com DDD.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Executa uma busca paginada de pessoa jurídica a partir de um telefone com DDD.`}),`\n`,_jsx(_components.p,{children:`Use esta rota quando você possui um telefone e precisa localizar possíveis empresas relacionadas a ele.`}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`phone`,type:`string`,required:true,placeholder:`1133334444`,id:`param-phone`,children:_jsx(_components.p,{children:`Telefone com DDD. Pontuação é aceita e removida automaticamente.`})}),`\n`,_jsx(ParamField,{body:`page`,default:`1`,type:`integer`,id:`param-page`,children:_jsxs(_components.p,{children:[`Página dos resultados. Use a próxima página enquanto `,_jsx(_components.code,{children:`has_more`}),` for `,_jsx(_components.code,{children:`true`}),`.`]})}),`\n`,_jsx(ParamField,{header:`x-ambient`,type:`string`,placeholder:`sandbox`,id:`param-x-ambient`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`sandbox`}),` para executar uma chamada de teste sem consumo de saldo.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Para detalhes sobre chamadas de teste, consulte `,_jsx(_components.a,{href:`/quickstart/sandbox`,children:`Ambiente de teste`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`regras-do-telefone`,children:`Regras do telefone`}),`\n`,_jsx(_components.p,{children:`O telefone deve conter DDD e 10 ou 11 dígitos após normalização.`}),`\n`,_jsxs(_components.p,{children:[`O prefixo internacional `,_jsx(_components.code,{children:`55`}),` é aceito e removido automaticamente quando informado.`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-corpo`,children:`Exemplo de corpo`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1133334444\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(ResponseField,{name:`code`,type:`integer`,required:true,id:`param-code`,children:_jsx(_components.p,{children:`Código da resposta da API.`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Mensagem descritiva da resposta.`})}),`\n`,_jsx(ResponseField,{name:`result`,type:`object`,required:true,id:`param-result`,children:_jsx(_components.p,{children:`Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.`})}),`\n`,_jsxs(Heading,{level:`2`,id:`estrutura-de-result`,children:[`Estrutura de `,_jsx(_components.code,{children:`result`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cobject>`})}),_jsx(_components.td,{children:`Registros encontrados para o telefone informado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`has_more`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se existe próxima página disponível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`integer`})}),_jsx(_components.td,{children:`Página retornada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Preço da busca para a conta autenticada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charged`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsxs(_components.td,{children:[`Valor debitado nesta chamada. Em sandbox, retorna `,_jsx(_components.code,{children:`0`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`debit_only_if_found`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se a cobrança ocorre apenas quando houver resultado útil.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`time`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Tempo de execução em segundos.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`test`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se a chamada foi executada em ambiente de teste.`})]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`estrutura-de-result-items`,children:[`Estrutura de `,_jsx(_components.code,{children:`result.items[]`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`taxid`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`CNPJ encontrado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Razão social.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`location`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Localização resumida, quando disponível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Situação cadastral.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`activity_start_date`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Data de abertura ou início de atividade no formato `,_jsx(_components.code,{children:`yyyy-mm-dd`}),`, quando disponível.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Campos de `,_jsx(_components.code,{children:`items[]`}),` podem não ser retornados em todas as consultas. A disponibilidade depende do telefone informado e dos dados existentes para os registros encontrados.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`paginação`,children:`Paginação`}),`\n`,_jsxs(_components.p,{children:[`Quando `,_jsx(_components.code,{children:`has_more`}),` retornar `,_jsx(_components.code,{children:`true`}),`, envie a mesma requisição incrementando `,_jsx(_components.code,{children:`page`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1133334444\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas-esperadas`,children:`Respostas esperadas`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Quando ocorre`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Busca executada com sucesso.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Requisição inválida, telefone ausente ou telefone em formato incompatível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`A chave da API está ausente, inválida ou não pôde ser autenticada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:`A credencial não possui escopo de consulta, o plano não permite acesso ou há bloqueio financeiro.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`fluxo-recomendado`,children:`Fluxo recomendado`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Informe o telefone com DDD.`}),`\n`,_jsxs(_components.li,{children:[`Leia `,_jsx(_components.code,{children:`items`}),` e verifique `,_jsx(_components.code,{children:`has_more`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Se `,_jsx(_components.code,{children:`has_more`}),` for `,_jsx(_components.code,{children:`true`}),`, consulte a próxima página.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`x-ambient: sandbox`}),` para validar integração sem consumir saldo.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Busca por telefone","description":"Busque pessoas jurídicas vinculadas a um telefone com DDD.","sidebarTitle":"Busca por telefone","api":"POST /v1/search/company/phone","playground":"interactive","href":"/api-reference/company/phone"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseExample,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Executa uma busca paginada de pessoa jurídica a partir de um telefone com DDD.`}),`\n`,_jsx(_components.p,{children:`Use esta rota quando você possui um telefone e precisa localizar possíveis empresas relacionadas a ele.`}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`22`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`22`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Consulta realizada com sucesso.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"taxid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"00.000.000/0000-00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EMPRESA EXEMPLO LTDA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"location\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"São Paulo/SP\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ATIVA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"activity_start_date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2020-01-15\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"has_more\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.09`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"charged\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.09`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"debit_only_if_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"time\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.42`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"test\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Um ou mais parâmetros informados são inválidos.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`401`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`401`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Credencial da API inválida.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`403`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`403`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A credencial da API não possui permissão para este recurso.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`phone`,type:`string`,required:true,placeholder:`1133334444`,id:`param-phone`,children:_jsx(_components.p,{children:`Telefone com DDD. Pontuação é aceita e removida automaticamente.`})}),`\n`,_jsx(ParamField,{body:`page`,default:`1`,type:`integer`,id:`param-page`,children:_jsxs(_components.p,{children:[`Página dos resultados. Use a próxima página enquanto `,_jsx(_components.code,{children:`has_more`}),` for `,_jsx(_components.code,{children:`true`}),`.`]})}),`\n`,_jsx(ParamField,{header:`x-ambient`,type:`string`,placeholder:`sandbox`,id:`param-x-ambient`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`sandbox`}),` para executar uma chamada de teste sem consumo de saldo.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Para detalhes sobre chamadas de teste, consulte `,_jsx(_components.a,{href:`/quickstart/sandbox`,children:`Ambiente de teste`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`regras-do-telefone`,children:`Regras do telefone`}),`\n`,_jsx(_components.p,{children:`O telefone deve conter DDD e 10 ou 11 dígitos após normalização.`}),`\n`,_jsxs(_components.p,{children:[`O prefixo internacional `,_jsx(_components.code,{children:`55`}),` é aceito e removido automaticamente quando informado.`]}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-de-corpo`,children:`Exemplo de corpo`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1133334444\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`resposta`,children:`Resposta`}),`\n`,_jsx(ResponseField,{name:`code`,type:`integer`,required:true,id:`param-code`,children:_jsx(_components.p,{children:`Código da resposta da API.`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Mensagem descritiva da resposta.`})}),`\n`,_jsx(ResponseField,{name:`result`,type:`object`,required:true,id:`param-result`,children:_jsx(_components.p,{children:`Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.`})}),`\n`,_jsxs(Heading,{level:`2`,id:`estrutura-de-result`,children:[`Estrutura de `,_jsx(_components.code,{children:`result`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`array\u003cobject>`})}),_jsx(_components.td,{children:`Registros encontrados para o telefone informado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`has_more`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se existe próxima página disponível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`page`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`integer`})}),_jsx(_components.td,{children:`Página retornada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Preço da busca para a conta autenticada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`charged`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsxs(_components.td,{children:[`Valor debitado nesta chamada. Em sandbox, retorna `,_jsx(_components.code,{children:`0`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`debit_only_if_found`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se a cobrança ocorre apenas quando houver resultado útil.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`time`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Tempo de execução em segundos.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`test`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`boolean`})}),_jsx(_components.td,{children:`Indica se a chamada foi executada em ambiente de teste.`})]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`estrutura-de-result-items`,children:[`Estrutura de `,_jsx(_components.code,{children:`result.items[]`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`taxid`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`CNPJ encontrado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Razão social.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`location`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Localização resumida, quando disponível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Situação cadastral.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`activity_start_date`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsxs(_components.td,{children:[`Data de abertura ou início de atividade no formato `,_jsx(_components.code,{children:`yyyy-mm-dd`}),`, quando disponível.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Campos de `,_jsx(_components.code,{children:`items[]`}),` podem não ser retornados em todas as consultas. A disponibilidade depende do telefone informado e dos dados existentes para os registros encontrados.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`paginação`,children:`Paginação`}),`\n`,_jsxs(_components.p,{children:[`Quando `,_jsx(_components.code,{children:`has_more`}),` retornar `,_jsx(_components.code,{children:`true`}),`, envie a mesma requisição incrementando `,_jsx(_components.code,{children:`page`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"phone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1133334444\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas-esperadas`,children:`Respostas esperadas`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Quando ocorre`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Busca executada com sucesso.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Requisição inválida, telefone ausente ou telefone em formato incompatível.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`A chave da API está ausente, inválida ou não pôde ser autenticada.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:`A credencial não possui escopo de consulta, o plano não permite acesso ou há bloqueio financeiro.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`fluxo-recomendado`,children:`Fluxo recomendado`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Informe o telefone com DDD.`}),`\n`,_jsxs(_components.li,{children:[`Leia `,_jsx(_components.code,{children:`items`}),` e verifique `,_jsx(_components.code,{children:`has_more`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Se `,_jsx(_components.code,{children:`has_more`}),` for `,_jsx(_components.code,{children:`true`}),`, consulte a próxima página.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.code,{children:`x-ambient: sandbox`}),` para validar integração sem consumir saldo.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Busca por telefone","description":"Busque pessoas jurídicas vinculadas a um telefone com DDD.","sidebarTitle":"Busca por telefone","api":"POST /v1/search/company/phone","playground":"interactive","href":"/api-reference/company/phone"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Corpo da requisição","slug":"corpo-da-requisição","depth":2,"children":[]},{"title":"Regras do telefone","slug":"regras-do-telefone","depth":2,"children":[]},{"title":"Exemplo de corpo","slug":"exemplo-de-corpo","depth":2,"children":[]},{"title":"Resposta","slug":"resposta","depth":2,"children":[]},{"title":"Estrutura de result","slug":"estrutura-de-result","depth":2,"children":[]},{"title":"Estrutura de result.items[]","slug":"estrutura-de-result-items","depth":2,"children":[]},{"title":"Paginação","slug":"paginação","depth":2,"children":[]},{"title":"Respostas esperadas","slug":"respostas-esperadas","depth":2,"children":[]},{"title":"Fluxo recomendado","slug":"fluxo-recomendado","depth":2,"children":[]}],"codeExamples":{"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"22\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Consulta realizada com sucesso.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"result\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"items\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"taxid\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"00.000.000/0000-00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"EMPRESA EXEMPLO LTDA\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"location\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"São Paulo/SP\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ATIVA\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"activity_start_date\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2020-01-15\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"has_more\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"page\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"price\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.09\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"charged\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.09\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"debit_only_if_found\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"time\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0.42\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"test\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">400\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Um ou mais parâmetros informados são inválidos.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"401","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">401\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Credencial da API inválida.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"403","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">403\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"A credencial da API não possui permissão para este recurso.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Busca por telefone","path":"/v1/search/company/phone","servers":[{"url":"https://api.lazydata.com.br/"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"x-ambient":{"schema":[{"type":"string","description":"Use `sandbox` para executar uma chamada de teste sem consumo de saldo.","placeholder":"sandbox"}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"phone":[{"type":"string","description":"Telefone com DDD. Pontuação é aceita e removida automaticamente.","required":true,"placeholder":"1133334444"}],"page":[{"type":"integer","description":"Página dos resultados. Use a próxima página enquanto `has_more` for `true` ."}]}}],"examples":{"example":{"value":{"phone":"\u003cstring>","page":123}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"code":[{"type":"integer","description":"Código da resposta da API.","required":true}],"message":[{"type":"string","description":"Mensagem descritiva da resposta.","required":true}],"result":[{"type":"object","properties":{},"description":"Objeto principal com os registros encontrados, dados de paginação, cobrança e tempo de execução.","required":true}]}}],"examples":{"example":{"value":{"code":123,"message":"\u003cstring>","result":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"cyberxcorp","siteName":"Lazy Data","title":"Busca por telefone - Lazy Data","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-23T17:22:23.736Z","originalFileLocation":"api-reference/company/phone.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Busque pessoas jurídicas vinculadas a um telefone com DDD.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Lazy Data, documentação API, consulta CPF, consulta CNPJ, validação cadastral, enriquecimento de dados, monitoramento processual\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lazy Data\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Busca por telefone - Lazy Data\">\u003cmeta data-mint-head property=\"og:description\" content=\"Busque pessoas jurídicas vinculadas a um telefone com DDD.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lazy Data\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lazydata.com.br/api-reference/company/phone\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cyberxcorp.mintlify.site/_mintlify/api/og/v2?division=Pessoa+jur%C3%ADdica\u0026amp;title=Busca+por+telefone\u0026amp;description=Busque+pessoas+jur%C3%ADdicas+vinculadas+a+um+telefone+com+DDD.\u0026amp;theme=016e3cf5d5f94690131247b4\u0026amp;signature=56a02f984743f2bfb49685692a66f3acb6fdc669fc4faf7fc919fd16420c66c1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Busca por telefone - Lazy Data\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Busque pessoas jurídicas vinculadas a um telefone com DDD.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cyberxcorp.mintlify.site/_mintlify/api/og/v2?division=Pessoa+jur%C3%ADdica\u0026amp;title=Busca+por+telefone\u0026amp;description=Busque+pessoas+jur%C3%ADdicas+vinculadas+a+um+telefone+com+DDD.\u0026amp;theme=016e3cf5d5f94690131247b4\u0026amp;signature=56a02f984743f2bfb49685692a66f3acb6fdc669fc4faf7fc919fd16420c66c1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cyberxcorp/_kAKUvgpGy4jiEAn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lazy Data\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7367F0\">\u003cmeta data-mint-head name=\"author\" content=\"Lazy Data\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lazydata.com.br/api-reference/company/phone\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/company/phone.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lazydata.com.br/#organization\",\"name\":\"Lazy Data\",\"url\":\"https://docs.lazydata.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cyberxcorp/z2RS7RlTD1bZLQlu/images/lazy_data_logo_with_name_black.png?fit=max\u0026auto=format\u0026n=z2RS7RlTD1bZLQlu\u0026q=85\u0026s=f1d89b5299cdc7216b929e0c2852c6c9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lazydata.com.br#website\",\"name\":\"Lazy Data\",\"url\":\"https://docs.lazydata.com.br\",\"publisher\":{\"@id\":\"https://docs.lazydata.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lazydata.com.br/api-reference/company/phone#webpage\",\"url\":\"https://docs.lazydata.com.br/api-reference/company/phone\",\"name\":\"Busca por telefone\",\"description\":\"Busque pessoas jurídicas vinculadas a um telefone com DDD.\",\"dateModified\":\"2026-06-23T17:22:23.736Z\",\"isPartOf\":{\"@id\":\"https://docs.lazydata.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lazydata.com.br/api-reference/company/phone#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lazydata.com.br/api-reference/company/phone#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Consultas\",\"item\":\"https://docs.lazydata.com.br/api-reference/search/datasets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Pessoa jurídica\",\"item\":\"https://docs.lazydata.com.br/api-reference/company/by-cnpj\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Busca por telefone\",\"item\":\"https://docs.lazydata.com.br/api-reference/company/phone\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.lazydata.com.br/api-reference/company/phone#apireference\",\"headline\":\"Busca por telefone\",\"name\":\"Busca por telefone\",\"description\":\"Busque pessoas jurídicas vinculadas a um telefone com DDD.\",\"url\":\"https://docs.lazydata.com.br/api-reference/company/phone\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lazydata.com.br/api-reference/company/phone#webpage\"},\"dateModified\":\"2026-06-23T17:22:23.736Z\",\"publisher\":{\"@id\":\"https://docs.lazydata.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lazydata.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lazy Data\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Lazy Data","nav":{"global":null,"tabs":[{"tab":"Documentação","icon":"file-alt","pages":[{"title":"Documentação","href":"/quickstart/introduction"}]},{"tab":"API reference","icon":"code","groups":[{"group":"Documentação","pages":[{"title":"Introdução","sidebarTitle":"Introdução","href":"/api-reference/introduction"}]},{"group":"Consultas","pages":[{"title":"Datasets e preços","api":"GET /v1/search/datasets/{target}","playground":"interactive","sidebarTitle":"Datasets e preços","openapi":"openapi.json GET /v1/search/datasets/{target}","href":"/api-reference/search/datasets"},{"title":"Resultado assíncrono","sidebarTitle":"Resultado assíncrono","api":"GET /v1/search/{target}/{history_id}","playground":"interactive","href":"/api-reference/search/async-result"},{"title":"Listar histórico","sidebarTitle":"Listar histórico","api":"GET /v1/search/history","playground":"interactive","href":"/api-reference/search/history-list"},{"title":"Detalhar histórico","sidebarTitle":"Detalhar histórico","api":"GET /v1/search/history/{history_id}","playground":"interactive","href":"/api-reference/search/history-detail"},{"group":"Pessoa física","icon":"user","pages":[{"title":"Busca por CPF","sidebarTitle":"Busca por CPF","api":"POST /v1/search/person","playground":"interactive","href":"/api-reference/search/person/by-cpf"},{"title":"Busca avançada","sidebarTitle":"Busca avançada","api":"POST /v1/search/person/advanced","playground":"interactive","href":"/api-reference/search/person/advanced"},{"title":"Busca por telefone","sidebarTitle":"Busca por telefone","api":"POST /v1/search/person/phone","playground":"interactive","href":"/api-reference/search/person/phone"},{"title":"Busca por e-mail","sidebarTitle":"Busca por e-mail","api":"POST /v1/search/person/email","playground":"interactive","href":"/api-reference/search/person/email"}]},{"group":"Pessoa jurídica","icon":"building","pages":[{"title":"Busca por CNPJ","sidebarTitle":"Busca por CNPJ","api":"POST /v1/search/company","playground":"interactive","href":"/api-reference/company/by-cnpj"},{"title":"Busca avançada","description":"Busque pessoas jurídicas por razão social, nome fantasia, CNPJ, endereço, UF ou CEP.","sidebarTitle":"Busca avançada","api":"POST https://api.lazydata.com.br/v1/search/company/advanced","playground":"interactive","href":"/api-reference/company/advanced"},{"title":"Busca por telefone","sidebarTitle":"Busca por telefone","api":"POST /v1/search/company/phone","playground":"interactive","href":"/api-reference/company/phone"},{"title":"Busca por e-mail","description":"Busque pessoas jurídicas vinculadas a um endereço de e-mail.","sidebarTitle":"Busca por e-mail","api":"POST /v1/search/company/email","playground":"interactive","href":"/api-reference/company/email"}]},{"group":"Processos","icon":"gavel","pages":[{"title":"Busca por CPF/CNPJ","sidebarTitle":"Busca por CPF/CNPJ","api":"POST /v1/search/process","playground":"interactive","href":"/api-reference/search/process"}]},{"group":"Veículos","icon":"car","pages":[{"title":"Busca por placa","sidebarTitle":"Busca por placa","api":"POST /v1/search/vehicle","playground":"interactive","href":"/api-reference/vehicle/plate"}]}]},{"group":"Validações","icon":"shield-check","pages":[{"title":"Comparação facial","sidebarTitle":"Comparação facial","api":"POST /v1/validation/facial/compare","playground":"interactive","href":"/comparacao-facial"},{"title":"Validação cadastral","sidebarTitle":"Validação cadastral","api":"POST /v1/validation/registration","playground":"interactive","href":"/validacao-cadastral"}]},{"group":"Monitoramento","icon":"bell","pages":[{"title":"Monitoramento","sidebarTitle":"Visão geral","href":"/api-reference/monitoring/overview"},{"title":"Listar monitoramentos","sidebarTitle":"Listar","api":"GET /v1/monitoring","playground":"interactive","href":"/api-reference/monitoring/list"},{"title":"Detalhar monitoramento","sidebarTitle":"Detalhar","api":"GET /v1/monitoring/{monitoring_id}","playground":"interactive","href":"/api-reference/monitoring/detail"},{"title":"Cancelar monitoramento","sidebarTitle":"Cancelar","api":"DELETE /v1/monitoring/{monitoring_id}","playground":"interactive","href":"/api-reference/monitoring/cancel"},{"group":"Processo","icon":"gavel","pages":[{"title":"Configuração","sidebarTitle":"Configuração","api":"GET /v1/monitoring/process/config","playground":"interactive","href":"/api-reference/monitoring/process/config"},{"title":"Detectar tribunal","sidebarTitle":"Detectar tribunal","api":"POST /v1/monitoring/process/detect-court","playground":"interactive","href":"/api-reference/monitoring/process/detect-court"},{"title":"Validar processo","sidebarTitle":"Validar processo","api":"POST /v1/monitoring/process/validate","playground":"interactive","href":"/api-reference/monitoring/process/validate"},{"title":"Criar monitoramento","sidebarTitle":"Criar","api":"POST /v1/monitoring/process","playground":"interactive","href":"/api-reference/monitoring/process/create"}]},{"group":"Pessoa física","icon":"user","pages":[{"title":"Configuração","sidebarTitle":"Configuração","api":"GET /v1/monitoring/person/config","playground":"interactive","href":"/api-reference/monitoring/person/config"},{"title":"Validar pessoa física","sidebarTitle":"Validar","api":"POST /v1/monitoring/person/validate","playground":"interactive","href":"/api-reference/monitoring/person/validate"},{"title":"Criar monitoramento","sidebarTitle":"Criar","api":"POST /v1/monitoring/person","playground":"interactive","href":"/api-reference/monitoring/person/create"}]},{"group":"Pessoa jurídica","icon":"building","pages":[{"title":"Configuração","sidebarTitle":"Configuração","api":"GET /v1/monitoring/company/config","playground":"interactive","href":"/api-reference/monitoring/company/config"},{"title":"Validar pessoa jurídica","sidebarTitle":"Validar","api":"POST /v1/monitoring/company/validate","playground":"interactive","href":"/api-reference/monitoring/company/validate"},{"title":"Criar monitoramento","sidebarTitle":"Criar","api":"POST /v1/monitoring/company","playground":"interactive","href":"/api-reference/monitoring/company/create"}]}]},{"group":"Enriquecimento","icon":"layer-group","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","href":"/api-reference/enrichment/overview"},{"title":"Datasets disponíveis","sidebarTitle":"Datasets disponíveis","api":"GET /v1/enrichment/datasets/{target}","playground":"interactive","href":"/api-reference/enrichment/datasets"},{"title":"Criar enriquecimento","sidebarTitle":"Criar enriquecimento","api":"POST /v1/enrichment","playground":"interactive","href":"/api-reference/enrichment/create"},{"title":"Listar enriquecimentos","sidebarTitle":"Listar enriquecimentos","api":"GET /v1/enrichment","playground":"interactive","href":"/api-reference/enrichment/list"},{"title":"Consultar status","sidebarTitle":"Consultar status","api":"GET /v1/enrichment/{enrichment_id}","playground":"interactive","href":"/api-reference/enrichment/status"},{"title":"Configurar e executar","sidebarTitle":"Configurar e executar","api":"POST /v1/enrichment/{enrichment_id}/start","playground":"interactive","href":"/api-reference/enrichment/configure"},{"title":"Arquivos de saída","sidebarTitle":"Arquivos de saída","api":"GET /v1/enrichment/{enrichment_id}/outputs/{output_type}","playground":"interactive","href":"/api-reference/enrichment/output-files"}]},{"group":"Armazenamento","icon":"folder-open","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","href":"/api-reference/storage/overview"},{"title":"Listar itens","sidebarTitle":"Listar itens","api":"GET /v1/storage/items","playground":"interactive","href":"/api-reference/storage/list-items"},{"title":"Criar pasta","sidebarTitle":"Criar pasta","api":"POST /v1/storage/folders","playground":"interactive","href":"/api-reference/storage/create-folder"},{"title":"Preparar upload","sidebarTitle":"Preparar upload","api":"POST /v1/storage/uploads","playground":"interactive","href":"/api-reference/storage/prepare-upload"},{"title":"Gerar download","sidebarTitle":"Gerar download","api":"GET /v1/storage/files/{file_id}/download","playground":"interactive","href":"/api-reference/storage/download-file"},{"title":"Renomear item","sidebarTitle":"Renomear item","api":"PATCH /v1/storage/items/{item_type}/{item_id}","playground":"interactive","href":"/api-reference/storage/rename-item"},{"title":"Excluir item","sidebarTitle":"Excluir item","api":"DELETE /v1/storage/items/{item_type}/{item_id}","playground":"interactive","href":"/api-reference/storage/delete-item"}]},{"group":"Upload de arquivos","icon":"cloud-upload","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","href":"/api-reference/upload/overview"},{"title":"Enriquecimento","sidebarTitle":"Enriquecimento","api":"POST https://upload.lazydata.com.br/enrichment","playground":"interactive","href":"/api-reference/upload/enrichment"},{"title":"Armazenamento","sidebarTitle":"Armazenamento","api":"POST https://upload.lazydata.com.br/storage","playground":"interactive","href":"/api-reference/upload/storage"}]}]}]},"basePath":"","title":"Busca por telefone - Lazy Data","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js"]}