Autentique com uma chave secreta (sk_live_…) ou uma chave restrita
(rk_live_…) criada no painel. Chaves restritas só têm as permissões
escolhidas na criação, como messages:send, chats:read ou
broadcasts:send.
pending_link nunca foi conectado. connecting está conectando ou
reconectando. connected pode enviar e receber. disconnected foi
desconectado e precisa ser conectado de novo.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"blü","description":"Guias do blü para conectar seu WhatsApp, enviar campanhas e configurar seu atendimento.","colors":{"primary":"#1372D8","light":"#60BFFB","dark":"#1372D8"},"logo":{"light":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-light.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c1dcb7084caf500aa1bfc7cdeb9b6ac0","dark":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=fa99a453fc822cd3eba2e6a691d211f8"},"favicon":"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/favicon.png?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c2c1393657e4303529d0c50baafac6cd","appearance":{"default":"light"},"navbar":{"links":[{"href":"https://blu.direct","label":"Site"},{"href":"https://wa.me/559186130008?text=Ol%C3%A1%2C+preciso+de+ajuda+com+o+Bl%C3%BC","label":"Suporte"}],"primary":{"type":"button","label":"Abrir painel","href":"https://blu.direct/app"}},"footer":{"socials":{"instagram":"https://instagram.com/blu.direct"},"links":[{"header":"blü","items":[{"label":"Site","href":"https://blu.direct"},{"label":"Blog","href":"https://blu.direct/blog"},{"label":"Privacidade","href":"https://blu.direct/privacy-policy"}]}]},"fonts":{"family":"IBM Plex Sans"},"integrations":{"posthog":{"apiKey":"phc_d8dj2oBM4jNkdVwrYwk9vufNUSLIJBj3uxOxg27NEnk","apiHost":"https://p.blu.direct","sessionRecording":false}},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"blu-direct","hasAudioNarration":false,"actualSubdomain":"blu-direct","customDomains":["docs.blu.direct"],"gitSource":{"type":"github","owner":"leoffx","repo":"blu","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adb7f2d2d3c9c6f3279f179","collectionId":"f28bf980-b5d9-4af3-b68d-080d3c8f26ed","liveDeploymentHistoryId":"6adb7f2d2d3c9c6f3279f179","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6adb7f2d2d3c9c6f3279f179","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"pt-BR","tag":"API \u0026 SDKs","count":45},{"language":"pt-BR","tag":"Referência da API","count":43},{"language":"pt-BR","tag":"Guias","count":28},{"language":"pt-BR","tag":"Campanhas","count":9},{"language":"pt-BR","tag":"Atendimento","count":6},{"language":"pt-BR","tag":"Comece por aqui","count":6},{"language":"pt-BR","tag":"Contatos","count":6},{"language":"pt-BR","tag":"Integrações","count":5},{"language":"pt-BR","tag":"Endpoints de webhook","count":5},{"language":"pt-BR","tag":"Etiquetas","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":".dark img[src*=\"/images/icons/\"]{filter:invert(1)}"}],"page":{"pagePath":"api-reference/números/consultar-um-número","slug":"/api-reference/números/consultar-um-número","pageMetadata":{"title":"Consultar um número","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers/{phone_number}","href":"/api-reference/números/consultar-um-número","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Consultar um número","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers/{phone_number}","href":"/api-reference/números/consultar-um-número","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Números"],"operationId":"getPhoneNumber","summary":"Consultar um número","parameters":["f4987592-92d9-4c45-981c-bc71d0a32073"],"responses":{"200":"8be5775c-27b0-4296-a0d8-f4b102f6b664","4XX":"33b616d6-4c48-4b9b-a55e-c90fef643fcc","5XX":"0e541f0d-2b27-420e-8acb-3c88ec779e9f"},"method":"get","type":"path","servers":["a7e13cee-51ea-4adc-ac59-16049f87cb99"],"security":["9b5a2af2-07dc-4788-9af3-526735b82f4a"],"path":"/v1/phone_numbers/{phone_number}","baseUrlOptions":["https://api.blu.direct"],"title":"Consultar um número","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f4987592-92d9-4c45-981c-bc71d0a32073":{"name":"expand[]","in":"query","description":"Campos a expandir em objetos completos, como `contact`, ou `data.contact` em listas.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"Campos a expandir em objetos completos, como `contact`, ou `data.contact` em listas.","uniqueKey":"","typeLabel":"string[]"}},"6e80cc7f-4ee7-4353-9005-11651a13d19a":{"name":"phone_number","in":"path","required":true,"schema":{"type":"string","pattern":"^pn_","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"4d283824-a3fa-4db8-a382-123a5e01e09c":{"name":"Blu-Version","in":"header","description":"A versão da API a usar. Por padrão, é a versão fixada na sua conta.","schema":{"type":"string","examples":["2026-10-11"],"description":"A versão da API a usar. Por padrão, é a versão fixada na sua conta.","uniqueKey":"","typeLabel":"string"}}},"responses":{"8be5775c-27b0-4296-a0d8-f4b102f6b664":{"description":"O número.","content":{"application/json":{"schema":{"type":"object","required":["id","object","name","display_phone_number","wa_id","verified_name","platform_type","status","quality_rating","capabilities","agent","created"],"properties":{"id":{"type":"string","pattern":"^pn_","examples":["pn_8f3aK1"],"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"phone_number","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"name":{"description":"O nome que você deu ao número.","type":"string","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"display_phone_number":{"oneOf":[{"type":"string","examples":["+55 11 99999-8888"],"isRequired":true,"uniqueKey":"display_phone_number.oneOf.0","typeLabel":"string"},{"type":"null","examples":["+55 11 99999-8888"],"isRequired":true,"uniqueKey":"display_phone_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"display_phone_number","typeLabel":"string | null"},"wa_id":{"oneOf":[{"description":"Nulo até o número ser conectado pela primeira vez.","type":"string","examples":["5511999998888"],"isRequired":true,"uniqueKey":"wa_id.oneOf.0","typeLabel":"string"},{"description":"Nulo até o número ser conectado pela primeira vez.","type":"null","examples":["5511999998888"],"isRequired":true,"uniqueKey":"wa_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"wa_id","typeLabel":"string | null"},"verified_name":{"oneOf":[{"description":"O nome comercial ou de perfil no WhatsApp.","type":"string","isRequired":true,"uniqueKey":"verified_name.oneOf.0","typeLabel":"string"},{"description":"O nome comercial ou de perfil no WhatsApp.","type":"null","isRequired":true,"uniqueKey":"verified_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"verified_name","typeLabel":"string | null"},"platform_type":{"description":"A plataforma do número. Hoje, todos os números usam a API do WhatsApp\nCloud, da Meta.\n","type":"string","enum":["cloud_api"],"isRequired":true,"uniqueKey":"platform_type","typeLabel":"enum\u003cstring>"},"status":{"description":"`pending_link` nunca foi conectado. `connecting` está conectando ou\nreconectando. `connected` pode enviar e receber. `disconnected` foi\ndesconectado e precisa ser conectado de novo.\n","type":"string","enum":["pending_link","connecting","connected","disconnected"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"quality_rating":{"oneOf":[{"description":"A classificação de qualidade da Meta. Nula até a Meta classificar o número.","type":"string","enum":["GREEN","YELLOW","RED","UNKNOWN",null],"isRequired":true,"uniqueKey":"quality_rating.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"A classificação de qualidade da Meta. Nula até a Meta classificar o número.","type":"null","enum":["GREEN","YELLOW","RED","UNKNOWN",null],"isRequired":true,"uniqueKey":"quality_rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"quality_rating","typeLabel":"enum\u003cstring> | null"},"capabilities":{"description":"O que este número permite. Confira antes de usar recursos que mudam conforme o tipo de plataforma.","type":"object","required":["chats","free_form_messages","polls","view_once","delivery_receipts"],"properties":{"chats":{"description":"Se as conversas e mensagens dele estão disponíveis pela API.","type":"boolean","isRequired":true,"uniqueKey":"capabilities.chats","typeLabel":"boolean"},"free_form_messages":{"description":"`always` (sempre) ou `service_window` (só dentro da janela de atendimento de 24 horas após a última mensagem do contato).","type":"string","enum":["always","service_window"],"isRequired":true,"uniqueKey":"capabilities.free_form_messages","typeLabel":"enum\u003cstring>"},"polls":{"type":"boolean","isRequired":true,"uniqueKey":"capabilities.polls","typeLabel":"boolean"},"view_once":{"type":"boolean","isRequired":true,"uniqueKey":"capabilities.view_once","typeLabel":"boolean"},"delivery_receipts":{"description":"Se as mensagens informam `delivered` e `read`.","type":"boolean","isRequired":true,"uniqueKey":"capabilities.delivery_receipts","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"capabilities","typeLabel":"object"},"agent":{"oneOf":[{"type":"string","description":"O agente que responde às conversas deste número. Expansível.","pattern":"^agent_","isRequired":true,"uniqueKey":"agent.oneOf.0","typeLabel":"string"},{"type":"object","description":"O agente que responde às conversas deste número. Expansível.","required":["id","object","name","instructions","faq","created"],"properties":{"id":{"type":"string","pattern":"^agent_","examples":["agent_12Rf"],"isRequired":true,"uniqueKey":"agent.oneOf.1.id","typeLabel":"string"},"object":{"type":"string","const":"agent","isRequired":true,"uniqueKey":"agent.oneOf.1.object","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"agent.oneOf.1.name","typeLabel":"string"},"instructions":{"description":"Como o agente deve se comportar e o que ele sabe.","type":"string","isRequired":true,"uniqueKey":"agent.oneOf.1.instructions","typeLabel":"string"},"faq":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["question","answer"],"properties":{"question":{"type":"string","isRequired":true,"uniqueKey":"agent.oneOf.1.faq.items.[INDEX].question","typeLabel":"string"},"answer":{"type":"string","isRequired":true,"uniqueKey":"agent.oneOf.1.faq.items.[INDEX].answer","typeLabel":"string"}},"uniqueKey":"agent.oneOf.1.faq.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"agent.oneOf.1.faq","typeLabel":"object[]"},"created":{"description":"Horário Unix em segundos.","type":"integer","examples":[1760190012],"isRequired":true,"uniqueKey":"agent.oneOf.1.created","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"agent.oneOf.1","typeLabel":"object"},{"type":"null","description":"O agente que responde às conversas deste número. Expansível.","isRequired":true,"uniqueKey":"agent.oneOf.2","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent","typeLabel":"string | object | null"},"created":{"description":"Horário Unix em segundos.","type":"integer","examples":[1760190012],"isRequired":true,"uniqueKey":"created","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"pn_8f3aK1","object":"phone_number","name":"\u003cstring>","display_phone_number":"+55 11 99999-8888","wa_id":"5511999998888","verified_name":"\u003cstring>","platform_type":"cloud_api","status":"pending_link","quality_rating":"GREEN","capabilities":{"chats":true,"free_form_messages":"always","polls":true,"view_once":true,"delivery_receipts":true},"agent":"\u003cstring>","created":1760190012}}},"exampleType":"generated"}},"exampleType":"generated"},"33b616d6-4c48-4b9b-a55e-c90fef643fcc":{"description":"A requisição falhou. Códigos de status: `400` requisição inválida, `401`\nchave de API inválida, `403` a chave não tem a permissão, `404` não\nencontrado, `409` conflito (como uma `Idempotency-Key` reutilizada com\nparâmetros diferentes), `422` uma regra do WhatsApp recusou a requisição,\n`429` limite de requisições atingido, `5xx` erro do lado do blü.\n","headers":{"Request-Id":{"description":"Identifica a requisição. Informe esse valor ao falar com o suporte.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","whatsapp_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"description":"Uma mensagem legível para pessoas.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"code":{"description":"Um texto curto que identifica o erro específico, quando houver.\n\n- `whatsapp_error`: `phone_number_disconnected`, `not_on_whatsapp`,\n `outside_service_window`, `template_not_approved`,\n `unsupported_for_platform_type`, `contact_opted_out`,\n `marketing_stopped`, `media_too_large`.\n- `invalid_request_error`: `parameter_missing`, `parameter_invalid`,\n `resource_missing`, `idempotency_key_reused`,\n `broadcast_not_draft`, `consent_required`, `plan_limit_reached`.\n","type":"string","examples":["outside_service_window"],"uniqueKey":"error.code","typeLabel":"string"},"param":{"description":"O parâmetro da requisição relacionado ao erro, se houver.","type":"string","examples":["text.body"],"uniqueKey":"error.param","typeLabel":"string"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","request_id":"\u003cstring>","code":"outside_service_window","param":"text.body","doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0e541f0d-2b27-420e-8acb-3c88ec779e9f":{"description":"A requisição falhou. Códigos de status: `400` requisição inválida, `401`\nchave de API inválida, `403` a chave não tem a permissão, `404` não\nencontrado, `409` conflito (como uma `Idempotency-Key` reutilizada com\nparâmetros diferentes), `422` uma regra do WhatsApp recusou a requisição,\n`429` limite de requisições atingido, `5xx` erro do lado do blü.\n","headers":{"Request-Id":{"description":"Identifica a requisição. Informe esse valor ao falar com o suporte.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","message","request_id"],"properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","whatsapp_error","rate_limit_error","api_error"],"isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"description":"Uma mensagem legível para pessoas.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"code":{"description":"Um texto curto que identifica o erro específico, quando houver.\n\n- `whatsapp_error`: `phone_number_disconnected`, `not_on_whatsapp`,\n `outside_service_window`, `template_not_approved`,\n `unsupported_for_platform_type`, `contact_opted_out`,\n `marketing_stopped`, `media_too_large`.\n- `invalid_request_error`: `parameter_missing`, `parameter_invalid`,\n `resource_missing`, `idempotency_key_reused`,\n `broadcast_not_draft`, `consent_required`, `plan_limit_reached`.\n","type":"string","examples":["outside_service_window"],"uniqueKey":"error.code","typeLabel":"string"},"param":{"description":"O parâmetro da requisição relacionado ao erro, se houver.","type":"string","examples":["text.body"],"uniqueKey":"error.param","typeLabel":"string"},"doc_url":{"type":"string","format":"uri","uniqueKey":"error.doc_url","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"invalid_request_error","message":"\u003cstring>","request_id":"\u003cstring>","code":"outside_service_window","param":"text.body","doc_url":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9b5a2af2-07dc-4788-9af3-526735b82f4a":{"secretKey":{"type":"http","scheme":"bearer","description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","scopes":[],"schemeName":"secretKey"}}},"servers":{"a7e13cee-51ea-4adc-ac59-16049f87cb99":{"url":"https://api.blu.direct"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","scopes":[],"schemeName":"secretKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Autentique com uma chave secreta (`sk_live_…`) ou uma chave restrita\n(`rk_live_…`) criada no painel. Chaves restritas só têm as permissões\nescolhidas na criação, como `messages:send`, `chats:read` ou\n`broadcasts:send`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"secretKey","name":"Authorization"}],"title":"secretKey"}]},"originalFileLocation":"api/openapi.yaml"},"subdomain":"blu-direct","siteName":"blü","title":"Consultar um número - blü","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/api-reference/números/consultar-um-número","matchLevel":0}}},"lastModified":"2026-10-23T15:37:36.924Z","originalFileLocation":"api-reference/números/consultar-um-número.mdx","locale":"pt-BR"},"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=\"light\"}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=\"application-name\" content=\"blü\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Consultar um número - blü\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"blü\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.blu.direct/api-reference/números/consultar-um-número\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://blu-direct.mintlify.app/_mintlify/api/og/v2?division=N%C3%BAmeros\u0026amp;title=Consultar+um+n%C3%BAmero\u0026amp;theme=bd8bce0f56b5608060d22437\u0026amp;signature=93fdfc92304882f59fd4997b50396dc03d4ff67c87fae9fa4562f72b047aa177\">\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=\"Consultar um número - blü\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://blu-direct.mintlify.app/_mintlify/api/og/v2?division=N%C3%BAmeros\u0026amp;title=Consultar+um+n%C3%BAmero\u0026amp;theme=bd8bce0f56b5608060d22437\u0026amp;signature=93fdfc92304882f59fd4997b50396dc03d4ff67c87fae9fa4562f72b047aa177\">\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/blu-direct/yPgrVpF5wEWF6j0S/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"blü\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1372D8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.blu.direct/api-reference/números/consultar-um-número\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.blu.direct/#organization\",\"name\":\"blü\",\"url\":\"https://docs.blu.direct\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/blu-direct/Hl1PYGRVJfCuUquW/images/logo-light.svg?fit=max\u0026auto=format\u0026n=Hl1PYGRVJfCuUquW\u0026q=85\u0026s=c1dcb7084caf500aa1bfc7cdeb9b6ac0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.blu.direct#website\",\"name\":\"blü\",\"url\":\"https://docs.blu.direct\",\"publisher\":{\"@id\":\"https://docs.blu.direct/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero#webpage\",\"url\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero\",\"name\":\"Consultar um número\",\"dateModified\":\"2026-10-23T15:37:36.924Z\",\"isPartOf\":{\"@id\":\"https://docs.blu.direct#website\"},\"breadcrumb\":{\"@id\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Referência da API\",\"item\":\"https://docs.blu.direct/api-reference/conta/consultar-a-conta\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Números\",\"item\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/listar-n%C3%BAmeros\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Consultar um número\",\"item\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero#apireference\",\"headline\":\"Consultar um número\",\"name\":\"Consultar um número\",\"url\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero\",\"mainEntityOfPage\":{\"@id\":\"https://docs.blu.direct/api-reference/n%C3%BAmeros/consultar-um-n%C3%BAmero#webpage\"},\"dateModified\":\"2026-10-23T15:37:36.924Z\",\"publisher\":{\"@id\":\"https://docs.blu.direct/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.blu.direct#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"blü\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"blü","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"Guias","pages":[{"title":"Guias","href":""}]},{"tab":"API \u0026 SDKs","groups":[{"group":"Desenvolvedores","pages":[{"title":"Desenvolva com o blü","sidebarTitle":"API e ferramentas","icon":"https://mintlify.s3.us-west-1.amazonaws.com/blu-direct/images/icons/code.svg","href":"/api/visao-geral"},{"title":"SDKs do blü","sidebarTitle":"SDKs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/blu-direct/images/icons/sdk.svg","href":"/sdks/visao-geral"}]},{"group":"Referência da API","pages":[{"group":"Conta","pages":[{"title":"Consultar a conta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/account","href":"/api-reference/conta/consultar-a-conta"}]},{"group":"Números","pages":[{"title":"Listar números","description":"Os números são adicionados no painel, onde ficam vinculados ao seu plano.","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers","href":"/api-reference/números/listar-números"},{"title":"Consultar um número","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/phone_numbers/{phone_number}","href":"/api-reference/números/consultar-um-número"},{"title":"Atualizar um número","description":null,"deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/phone_numbers/{phone_number}","href":"/api-reference/números/atualizar-um-número"}]},{"group":"Contatos","pages":[{"title":"Listar contatos","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/contacts","href":"/api-reference/contatos/listar-contatos"},{"title":"Criar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts","href":"/api-reference/contatos/criar-um-contato"},{"title":"Consultar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/contacts/{contact}","href":"/api-reference/contatos/consultar-um-contato"},{"title":"Atualizar um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts/{contact}","href":"/api-reference/contatos/atualizar-um-contato"},{"title":"Excluir um contato","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/contacts/{contact}","href":"/api-reference/contatos/excluir-um-contato"},{"title":"Verificar números no WhatsApp","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/contacts/lookup","href":"/api-reference/contatos/verificar-números-no-whatsapp"}]},{"group":"Conversas","pages":[{"title":"Listar conversas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats","href":"/api-reference/conversas/listar-conversas"},{"title":"Abrir uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats","href":"/api-reference/conversas/abrir-uma-conversa"},{"title":"Consultar uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}","href":"/api-reference/conversas/consultar-uma-conversa"},{"title":"Atualizar uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats/{chat}","href":"/api-reference/conversas/atualizar-uma-conversa"}]},{"group":"Mensagens","pages":[{"title":"Listar as mensagens de uma conversa","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}/messages","href":"/api-reference/mensagens/listar-as-mensagens-de-uma-conversa"},{"title":"Enviar uma mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/chats/{chat}/messages","href":"/api-reference/mensagens/enviar-uma-mensagem"},{"title":"Consultar uma mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/chats/{chat}/messages/{message}","href":"/api-reference/mensagens/consultar-uma-mensagem"}]},{"group":"Mídia","pages":[{"title":"Enviar mídia","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/media","href":"/api-reference/mídia/enviar-mídia"},{"title":"Consultar mídia","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/media/{media}","href":"/api-reference/mídia/consultar-mídia"}]},{"group":"Etiquetas","pages":[{"title":"Listar etiquetas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/labels","href":"/api-reference/etiquetas/listar-etiquetas"},{"title":"Criar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/labels","href":"/api-reference/etiquetas/criar-uma-etiqueta"},{"title":"Consultar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/labels/{label}","href":"/api-reference/etiquetas/consultar-uma-etiqueta"},{"title":"Atualizar uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/labels/{label}","href":"/api-reference/etiquetas/atualizar-uma-etiqueta"},{"title":"Excluir uma etiqueta","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/labels/{label}","href":"/api-reference/etiquetas/excluir-uma-etiqueta"}]},{"group":"Modelos de mensagem","pages":[{"title":"Listar modelos de mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/message_templates","href":"/api-reference/modelos-de-mensagem/listar-modelos-de-mensagem"},{"title":"Consultar um modelo de mensagem","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/message_templates/{message_template}","href":"/api-reference/modelos-de-mensagem/consultar-um-modelo-de-mensagem"}]},{"group":"Campanhas","pages":[{"title":"Listar campanhas","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/broadcasts","href":"/api-reference/campanhas/listar-campanhas"},{"title":"Criar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts","href":"/api-reference/campanhas/criar-uma-campanha"},{"title":"Consultar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/broadcasts/{broadcast}","href":"/api-reference/campanhas/consultar-uma-campanha"},{"title":"Atualizar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts/{broadcast}","href":"/api-reference/campanhas/atualizar-uma-campanha"},{"title":"Enviar uma campanha","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/broadcasts/{broadcast}/send","href":"/api-reference/campanhas/enviar-uma-campanha"}]},{"group":"Agentes","pages":[{"title":"Listar agentes","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/agents","href":"/api-reference/agentes/listar-agentes"},{"title":"Consultar um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/agents/{agent}","href":"/api-reference/agentes/consultar-um-agente"},{"title":"Atualizar um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/agents/{agent}","href":"/api-reference/agentes/atualizar-um-agente"},{"title":"Simular um agente","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/agents/{agent}/simulate","href":"/api-reference/agentes/simular-um-agente"}]},{"group":"Eventos","pages":[{"title":"Listar eventos","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/events","href":"/api-reference/eventos/listar-eventos"},{"title":"Consultar um evento","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/events/{event}","href":"/api-reference/eventos/consultar-um-evento"},{"title":"Entrega de eventos","version":null,"deprecated":null,"openapi":"/api/openapi.yaml webhook event","href":"/api-reference/eventos/entrega-de-eventos"}]},{"group":"Endpoints de webhook","pages":[{"title":"Listar endpoints de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/listar-endpoints-de-webhook"},{"title":"Criar um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints","href":"/api-reference/endpoints-de-webhook/criar-um-endpoint-de-webhook"},{"title":"Consultar um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml get /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/consultar-um-endpoint-de-webhook"},{"title":"Atualizar um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml post /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/atualizar-um-endpoint-de-webhook"},{"title":"Excluir um endpoint de webhook","deprecated":null,"version":null,"openapi":"/api/openapi.yaml delete /v1/webhook_endpoints/{webhook_endpoint}","href":"/api-reference/endpoints-de-webhook/excluir-um-endpoint-de-webhook"}]}]}]}]}]},"title":"Consultar um número - blü","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}