API pública NovoDID · contrato 1.3.0. Inglês americano é a edição principal; português brasileiro e espanhol colombiano cobrem o mesmo contrato. O idioma da documentação não traduz campos, escopos, enums nem altera respostas da API; mensagens de erro podem permanecer em português.
\nListar seus números ativos (DIDs), consultar encaminhamentos, configurar siga-me/ramal SIP/IP público, criar ou reutilizar ramal durante o encaminhamento, consultar suas credenciais, listar chamadas recebidas e ler/enviar SMS elegíveis. Devolução de números, alterações de assinaturas, criação de tokens e administração de webhooks são feitas no painel. Tokens e webhooks são configurados no painel autenticado.
\nNo painel NovoDID, abra Desenvolvedores → Tokens e crie um token somente com as permissões e os números necessários. A API é liberada automaticamente para PF e PJ; bloqueios administrativos continuam valendo.
\nCopie o token na criação (exibição única) e guarde como valor local/privado de ambiente no Postman em novodid_token. Nunca coloque tokens reais em valores compartilhados, exemplos, exportações ou Git.
\nAjuste baseUrl para o ambiente desejado; padrão https://novodid.com. Execute primeiro GET /me e depois GET /dids com dids:read. Copie o id numérico autorizado para didId; o telefone não é o id.
\nOs filtros opcionais começam desativados. Ative apenas os necessários e preencha os destinos antes das escritas. Confira os exemplos de resposta antes de executar.
\nExecute escritas individualmente: elas mudam o encaminhamento real ou enviam SMS de verdade. A coleção não é sandbox e não deve ser executada inteira em produção. Exemplos são fictícios, sem dados de clientes.
\nToda requisição herda Authorization: Bearer , por HTTPS. Não existe escopo curinga. O token pode autorizar todos os números atuais/futuros ou 1–100 posses atuais selecionadas. A posse ativa é sempre conferida: uma associação antiga não permite ler SMS ou chamadas de outro cliente. Recomprar um número não reativa uma seleção antiga; emita um novo token com a seleção atual. Tokens expirados/revogados, bloqueios e recursos fora da seleção são recusados.
\nNome do token: 3–80 caracteres; máximo de 10 tokens ativos e não expirados. Validade: 7, 30, 90, 365 dias ou sem vencimento; sugestão do painel: 90 dias. Rotação invalida imediatamente o anterior e mantém permissões, seleção, vencimento e consumo das cotas. Tokens legados podem manter acesso amplo à conta; revise e substitua por permissões mínimas. Revogar token da API não invalida senha SIP que já foi consultada.
\nCotas padrão agregadas por conta, compartilhadas entre todos os tokens: leitura 60/min, escrita de encaminhamento 10/min, SMS 5/min e 100/dia UTC. Limites individuais mais restritivos são adicionais e não ampliam a cota. Criar/rotacionar tokens não reinicia consumo. Tentativas recusadas podem consumir cota. Verifique X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After; SMS também fornece X-RateLimit-Sms-Day-*. Em 429, aguarde o prazo e use retentativas limitadas com intervalo progressivo e variação aleatória.
\nCorpo JSON: até 16 KiB e 16 campos no primeiro nível. Query string: até 2048 caracteres; parâmetros desconhecidos ou duplicados são recusados. IDs inteiros entre 1 e 2147483647, sem decimais ou notação exponencial. Respostas com dados do cliente usam Cache-Control: no-store.
\nFormato de erro: {\"error\":{\"code\":\"...\",\"message\":\"...\",\"details\":{}}}; details é opcional. 400 entrada inválida; 401 token ausente/inválido/expirado; 403 escopo, bloqueio ou política SMS; 404 recurso indisponível para o token/posse atual; 408 timeout do corpo; 409 estado incompatível ou saldo insuficiente; 413 corpo excessivo; 429 cota; 502/503 indisponibilidade temporária. Corrija autenticação/validação antes de repetir. Um 404 não prova que o número não existe globalmente. Não repita SMS cegamente após timeout: o envio pode ter ocorrido e não existe contrato de chave de idempotência.
\nTipo de DID: fixo, movel ou unknown. Meio de pagamento: pix, card ou null. Sem billing:read, cycle/expiresAt/autoRenew/payment ficam null; sem forwarding:read, o destino fica oculto. Null significa indisponível ou sem permissão, não necessariamente desativado. A capacidade SMS independe do escopo: fixos não recebem SMS e móveis precisam cumprir elegibilidade. Datas usam o formato/fuso ISO retornado, não o fuso local presumido.
\nPainel somente leitura: dids:read, opcionalmente billing:read e forwarding:read; respeite cotas compartilhadas. Caixa SMS e resposta: sms:read + sms:send; responda com from=seu DID e to=remetente recebido. Softphone: forwarding:write + sip:create + sip:credentials:read; PATCH type=sip sem sipAccountId e configure servidor/usuário/senha/porta/transporte retornados. Inclua forwarding:read para consultar o destino. Siga-me: forwarding:phone e saldo na conta; tarifa de R$ 0,20/min desde o início da cobrança, sem franquia gratuita.
\nAbra Desenvolvedores → Webhooks e cadastre nome (3–80 caracteres), URL HTTPS pública (até 2048), eventos e filtro opcional de até 50 DIDs próprios. Filtro vazio inclui todos os números elegíveis. Credenciais na URL, hosts privados/locais e redirecionamentos não são aceitos. Eventos: sms.received, sms.sent, call.received, call.missed, payment.approved, did.expiring. Não há CRUD público v1 de webhooks nesta coleção; essas configurações não herdam escopos do token.
\nEnvelope: id, type, version, createdAt e data, com dados de did/sms/call/payment conforme evento. Testes têm data.test=true. Preserve o corpo bruto exato e confira X-Novodid-Signature: sha256= + HMAC-SHA256(segredo, X-Novodid-Timestamp + \".\" + corpoBruto). Compare em tempo constante, rejeite timestamps antigos (recomendado ±5 minutos) e deduplique por id do evento. X-Novodid-Event e X-Novodid-Delivery identificam o contexto.
\nPersista/enfileire o evento validado e retorne 2xx rapidamente. Prazo total de 8 segundos, sem redirects, captura limitada da resposta e até cinco tentativas com backoff. Falhas repetidas podem pausar o endpoint. Consulte logs de entrega e corrija conectividade, TLS, assinatura/corpo e tempo de resposta antes de retomar. Não há garantia de ordem, entrega exatamente uma vez ou replay histórico. A posse é revalidada antes da entrega; devolver um DID não transfere histórico ao próximo cliente.
\nPainel · OpenAPI · Guia detalhado.
\nExemplos somente leitura. Defina NOVODID_API_TOKEN no ambiente local; nunca fixe o segredo no código.
\ncurl --fail-with-body --max-time 15 \\\n https://novodid.com/api/v1/dids \\\n -H \"Authorization: Bearer $NOVODID_API_TOKEN\" \\\n -H \"Accept: application/json\"\n\nconst token = process.env.NOVODID_API_TOKEN;\nif (!token) throw new Error(\"NOVODID_API_TOKEN is required\");\nconst response = await fetch(\"https://novodid.com/api/v1/dids\", {\n headers: { Authorization: `Bearer ${token}`, Accept: \"application/json\" },\n signal: AbortSignal.timeout(15000),\n redirect: \"error\"\n});\nif (!response.ok) throw new Error(`HTTP ${response.status}`);\nconst { dids } = await response.json();\nconsole.log({ count: dids.length });\n\nimport os\nimport requests\nresponse = requests.get(\n \"https://novodid.com/api/v1/dids\",\n headers={\"Authorization\": \"Bearer \" + os.environ[\"NOVODID_API_TOKEN\"]},\n timeout=15,\n allow_redirects=False,\n)\nif response.status_code != 200:\n raise RuntimeError(f\"HTTP {response.status_code}\")\ndids = response.json()[\"dids\"]\nprint({\"count\": len(dids)})\n\nA referência NovoDID oferece a mesma cobertura de rotas, variantes de encaminhamento separadas, escopos cumulativos e exemplos em oito linguagens. HTTP 500 indica um erro interno.
\nPermissões: catalog:read consulta estoque e cotação; orders:create cria pedidos; orders:read consulta e lista pedidos da conta. Tokens existentes não recebem essas permissões automaticamente. Para comprar, o token deve permitir todos os números, sem restrição a posses existentes. A conta precisa estar ativa, autorizada a comprar, com verificação exigida concluída e capacidade disponível. Valem as mesmas regras de móveis, ciclos e SMS do painel.
\nCada pedido contém exatamente um DID. quantity pode ser omitido ou informado como o inteiro 1; listas e compras em lote são recusadas. A reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. Ciclos: mensal, semestral e anual. Valores em centavos de BRL, calculados pelo servidor. O catálogo informa o preço mensal de referência; a cotação inclui ciclo, descontos e taxa do cartão. Cotar não reserva o número.
\nApresente número, ciclo, valor recorrente e condições de SMS ao cliente. Somente após o aceite envie fixedDidSmsAcknowledged=true para fixos, ou mobileMonthlySmsAcknowledged=true quando exigido na cotação. O agente não deve presumir o consentimento do cliente.
\nPOST /api/v1/orders exige o cabeçalho Idempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e mantenha chave/corpo nas repetições. Alterar os dados com a mesma chave retorna 409 idempotency_conflict. Após timeout, consulte o pedido ou repita a mesma chave; não gere outra para contornar a falha. O erro pode informar details.orderId.
\nPix Automático retorna pix.copyPaste e pix.qrCodeDataUrl. Confira no aplicativo bancário o pagamento e a autorização recorrente. Cartão retorna checkoutUrl para o cliente concluir o pagamento. Criar o pedido não paga nem ativa o DID. O retorno do navegador não confirma o pagamento.
\nEstados do pedido: creating, awaiting_payment, paid (pago, aguardando ativação), active (ativação concluída), expired, cancelled, refunded, rejected e review_required. Consulte o pedido para acompanhar e /api/v1/dids para conferir a posse ativa atual. As instruções de pagamento aparecem apenas em awaiting_payment. A reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.
\nMCP remoto: https://mcp.novodid.com/mcp, transporte Streamable HTTP e o mesmo token Bearer da API NovoDID. Ferramentas: search_available_dids, quote_did_purchase, create_did_checkout, get_did_order e list_did_orders. A listagem respeita as permissões do token. create_did_checkout recebe idempotencyKey nos argumentos. Pix retorna copia e cola, imagem PNG e terminalQr para fonte monoespaçada. Se o cliente não exibir imagens, use o texto exato de copia e cola. O cliente MCP precisa permitir configurar o token Bearer.
\nO MCP remoto oferece todas as operações da API pública em 19 ferramentas, incluindo as cinco de compra. Conecte a https://mcp.novodid.com/mcp com Streamable HTTP e o mesmo token Bearer. A descoberta respeita escopos; a execução mantém posse atual, restrições do token, cotas e permissões de campos. billing:read libera pagamento e vencimento; account:read libera nome/e-mail; forwarding:read libera destinos. A criação de ramal exige as três permissões indicadas. Siga-me exige saldo e custa R$ 0,20/minuto, sem franquia gratuita. Envio de SMS não é idempotente: não repita automaticamente após resultado incerto. Confirme alterações com o cliente. Esta conexão não usa OAuth. Guia: https://novodid.com/desenvolvedores/mcp
\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.
\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.
\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\nA confirmação do telefone e da posse atual também é exigida nas operações de encaminhamento, credenciais SIP, chamadas e SMS. A indisponibilidade de leitura não altera o contrato financeiro.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"API pública NovoDID","slug":"api-publica-novodid"}],"owner":"44067300","collectionId":"977d3f09-0c15-4392-b897-06032f40645b","publishedId":"2sBYB2rnYZ","public":true,"customColor":{"top-bar":"ffffff","right-sidebar":"f7faf8","highlight":"0b8c5e"},"publishDate":"2026-09-23T22:47:07.000Z"},"item":[{"name":"Conta","item":[{"name":"Consultar conta e token","id":"89de3494-c931-4438-8cbe-569c79f0cc3c","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/me","description":"Qualquer token válido
\nAceita qualquer token válido da API. Retorna account.id, account.apiVersion e token.id/name/scopes. account:read também libera nome/e-mail. Não retorna o segredo. Use primeiro para conferir autenticação e permissões efetivas.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","me"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"c67bb033-6bc2-4255-9a1f-66c2506fbd37","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/me","description":"## Escopos necessários\n\nQualquer token válido\n\nAceita qualquer token válido da API. Retorna account.id, account.apiVersion e token.id/name/scopes. account:read também libera nome/e-mail. Não retorna o segredo. Use primeiro para conferir autenticação e permissões efetivas."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"account\": {\n \"id\": \"example-account\",\n \"apiVersion\": \"v1\"\n },\n \"token\": {\n \"id\": \"example-token\",\n \"name\": \"Read-only integration\",\n \"scopes\": [\n \"dids:read\"\n ]\n }\n}"},{"id":"4f72e75c-b7d4-46db-b21c-5f84381e3a13","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/me","description":"## Escopos necessários\n\nQualquer token válido\n\nAceita qualquer token válido da API. Retorna account.id, account.apiVersion e token.id/name/scopes. account:read também libera nome/e-mail. Não retorna o segredo. Use primeiro para conferir autenticação e permissões efetivas."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"c140aa21-899b-493c-87fe-9e407480d793","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/me","description":"## Escopos necessários\n\nQualquer token válido\n\nAceita qualquer token válido da API. Retorna account.id, account.apiVersion e token.id/name/scopes. account:read também libera nome/e-mail. Não retorna o segredo. Use primeiro para conferir autenticação e permissões efetivas.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"89de3494-c931-4438-8cbe-569c79f0cc3c"}],"id":"8aa0a362-4ebd-4959-b13f-7babed7068d0","_postman_id":"8aa0a362-4ebd-4959-b13f-7babed7068d0","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"Números","item":[{"name":"Listar números ativos","id":"f8d5a791-f14b-463b-826e-b85e279a622a","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids","description":"dids:read
Lista somente números ativos da conta e autorizados pelo token. Sem números acessíveis, retorna {dids: []}. Não é estoque à venda nem histórico de compras. Não aceita paginação/filtros. O exemplo oculta cobrança e encaminhamento por falta dos escopos correspondentes.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\nO campo number contém somente um telefone confirmado para a posse atual. Se essa confirmação estiver indisponível ou inconsistente, o item não aparece na listagem e a consulta por ID retorna 404 did_not_found. Tente consultar novamente mais tarde; se persistir, contate o suporte. O início de acesso ao histórico permanece o da posse atual.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"6442badd-589f-40da-b6de-03bac923be2e","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids","description":"## Escopos necessários\n\n`dids:read`\n\nLista somente números ativos da conta e autorizados pelo token. Sem números acessíveis, retorna {dids: []}. Não é estoque à venda nem histórico de compras. Não aceita paginação/filtros. O exemplo oculta cobrança e encaminhamento por falta dos escopos correspondentes."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"dids\": [\n {\n \"id\": 1234,\n \"number\": \"5511999999999\",\n \"type\": \"movel\",\n \"status\": \"active\",\n \"active\": true,\n \"cycle\": null,\n \"expiresAt\": null,\n \"autoRenew\": null,\n \"payment\": null,\n \"sms\": {\n \"enabled\": true,\n \"canSend\": true,\n \"accessStartedAt\": \"2026-09-23T12:00:00.000Z\"\n },\n \"forwarding\": null\n }\n ]\n}"},{"id":"107bb420-3221-4b31-a583-82f3284ab8fb","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids","description":"## Escopos necessários\n\n`dids:read`\n\nLista somente números ativos da conta e autorizados pelo token. Sem números acessíveis, retorna {dids: []}. Não é estoque à venda nem histórico de compras. Não aceita paginação/filtros. O exemplo oculta cobrança e encaminhamento por falta dos escopos correspondentes."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"c9fe8fd2-8bd7-41e8-9249-09a375d61d98","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids","description":"## Escopos necessários\n\n`dids:read`\n\nLista somente números ativos da conta e autorizados pelo token. Sem números acessíveis, retorna {dids: []}. Não é estoque à venda nem histórico de compras. Não aceita paginação/filtros. O exemplo oculta cobrança e encaminhamento por falta dos escopos correspondentes.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"f8d5a791-f14b-463b-826e-b85e279a622a"},{"name":"Consultar detalhes do número","id":"c129c4d1-9ecd-4c19-bd65-c6dc8d3a8f8b","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids/","description":"dids:read
Use o id numérico obtido em GET /dids, não o telefone. Exige posse ativa atual e seleção do token. Retorna {did: ...}; fora do acesso retorna 404. billing:read e forwarding:read controlam os campos adicionais descritos na introdução.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\nO campo number contém somente um telefone confirmado para a posse atual. Se essa confirmação estiver indisponível ou inconsistente, o item não aparece na listagem e a consulta por ID retorna 404 did_not_found. Tente consultar novamente mais tarde; se persistir, contate o suporte. O início de acesso ao histórico permanece o da posse atual.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids",""],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"6713ee7f-058a-4854-9412-f1636212e5ca","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids/","description":"## Escopos necessários\n\n`dids:read`\n\nUse o id numérico obtido em GET /dids, não o telefone. Exige posse ativa atual e seleção do token. Retorna {did: ...}; fora do acesso retorna 404. billing:read e forwarding:read controlam os campos adicionais descritos na introdução."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"did\": {\n \"id\": 1234,\n \"number\": \"5511999999999\",\n \"type\": \"movel\",\n \"status\": \"active\",\n \"active\": true,\n \"cycle\": null,\n \"expiresAt\": null,\n \"autoRenew\": null,\n \"payment\": null,\n \"sms\": {\n \"enabled\": true,\n \"canSend\": true,\n \"accessStartedAt\": \"2026-09-23T12:00:00.000Z\"\n },\n \"forwarding\": null\n }\n}"},{"id":"05491802-e3a9-406b-aabe-664e0fd6e36b","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids/","description":"## Escopos necessários\n\n`dids:read`\n\nUse o id numérico obtido em GET /dids, não o telefone. Exige posse ativa atual e seleção do token. Retorna {did: ...}; fora do acesso retorna 404. billing:read e forwarding:read controlam os campos adicionais descritos na introdução."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"8c58cf82-00f1-428c-b0d6-5f96fa19ba4b","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids/","description":"## Escopos necessários\n\n`dids:read`\n\nUse o id numérico obtido em GET /dids, não o telefone. Exige posse ativa atual e seleção do token. Retorna {did: ...}; fora do acesso retorna 404. billing:read e forwarding:read controlam os campos adicionais descritos na introdução.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"c129c4d1-9ecd-4c19-bd65-c6dc8d3a8f8b"}],"id":"0925f6a5-0d86-4790-acd9-dfac10c22fce","_postman_id":"0925f6a5-0d86-4790-acd9-dfac10c22fce","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"Encaminhamentos","item":[{"name":"Listar encaminhamentos","id":"59d1fa80-bdb8-4bc5-825b-70b65fcec1e2","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/forwardings","description":"forwarding:read
Retorna {forwardings: [{didId, number, forwarding}]} dos DIDs atuais autorizados. forwarding contém type e destination, ou fica indisponível/null. Sem paginação. Esta permissão revela destinos; conceda somente quando necessário.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","forwardings"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"178c7e08-a3af-4ea8-9e0a-fb79a4c35667","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/forwardings","description":"## Escopos necessários\n\n`forwarding:read`\n\nRetorna {forwardings: [{didId, number, forwarding}]} dos DIDs atuais autorizados. forwarding contém type e destination, ou fica indisponível/null. Sem paginação. Esta permissão revela destinos; conceda somente quando necessário."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"forwardings\": [\n {\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": {\n \"type\": \"sip\",\n \"destination\": \"example-extension\"\n }\n }\n ]\n}"},{"id":"147c4bba-7c71-4ba0-afbe-88aeb4c58240","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/forwardings","description":"## Escopos necessários\n\n`forwarding:read`\n\nRetorna {forwardings: [{didId, number, forwarding}]} dos DIDs atuais autorizados. forwarding contém type e destination, ou fica indisponível/null. Sem paginação. Esta permissão revela destinos; conceda somente quando necessário."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"f967bd79-c124-4adb-9bf8-7a7a80c811ab","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/forwardings","description":"## Escopos necessários\n\n`forwarding:read`\n\nRetorna {forwardings: [{didId, number, forwarding}]} dos DIDs atuais autorizados. forwarding contém type e destination, ou fica indisponível/null. Sem paginação. Esta permissão revela destinos; conceda somente quando necessário.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"59d1fa80-bdb8-4bc5-825b-70b65fcec1e2"},{"name":"Consultar encaminhamento do número","id":"5b030f72-a99e-4cc9-85dc-84415c0e4dd4","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:read
Consulta a configuração de um número autorizado. Retorna didId, number e forwarding. Não retorna senha SIP; use a consulta de credenciais e sua permissão sensível.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"a49a2288-9674-4a8c-82dc-14c67ff62e08","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:read`\n\nConsulta a configuração de um número autorizado. Retorna didId, number e forwarding. Não retorna senha SIP; use a consulta de credenciais e sua permissão sensível."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": {\n \"type\": \"sip\",\n \"destination\": \"example-extension\"\n }\n}"},{"id":"40401d61-69c6-4424-8744-eff479e129f3","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:read`\n\nConsulta a configuração de um número autorizado. Retorna didId, number e forwarding. Não retorna senha SIP; use a consulta de credenciais e sua permissão sensível."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"881e3769-6823-4cf2-a2e5-4412028833a5","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:read`\n\nConsulta a configuração de um número autorizado. Retorna didId, number e forwarding. Não retorna senha SIP; use a consulta de credenciais e sua permissão sensível.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"5b030f72-a99e-4cc9-85dc-84415c0e4dd4"},{"name":"Encaminhar para telefone (tarifado)","id":"8d93a3fb-97ad-4d43-8911-5ffb1323e697","request":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"phone\",\n \"destinationNumber\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:phone
Substitui o destino atual. destinationNumber deve conter 55 + DDD + número, 12 ou 13 dígitos; destination também é aceito. Não aceita 0800. Exige saldo. Chamadas encaminhadas custam R$ 0,20/min, sem minutos gratuitos. Não libera encaminhamento SIP/IP. Inclua forwarding:read para ver o destino na resposta; sem ele, forwarding é null.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"d4ba6d44-9875-4a34-a3ec-4f41466a0831","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"phone\",\n \"destinationNumber\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:phone`\n\nSubstitui o destino atual. destinationNumber deve conter 55 + DDD + número, 12 ou 13 dígitos; destination também é aceito. Não aceita 0800. Exige saldo. Chamadas encaminhadas custam R$ 0,20/min, sem minutos gratuitos. Não libera encaminhamento SIP/IP. Inclua forwarding:read para ver o destino na resposta; sem ele, forwarding é null."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": null\n}"},{"id":"06f068ff-fbf6-4f1d-b96c-0e12b8756bb2","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"phone\",\n \"destinationNumber\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:phone`\n\nSubstitui o destino atual. destinationNumber deve conter 55 + DDD + número, 12 ou 13 dígitos; destination também é aceito. Não aceita 0800. Exige saldo. Chamadas encaminhadas custam R$ 0,20/min, sem minutos gratuitos. Não libera encaminhamento SIP/IP. Inclua forwarding:read para ver o destino na resposta; sem ele, forwarding é null."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"935860d1-2f47-4a8b-82e1-163a3603b928","name":"403 account_security_review","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"phone\",\n \"destinationNumber\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:phone`\n\nSubstitui o destino atual. destinationNumber deve conter 55 + DDD + número, 12 ou 13 dígitos; destination também é aceito. Não aceita 0800. Exige saldo. Chamadas encaminhadas custam R$ 0,20/min, sem minutos gratuitos. Não libera encaminhamento SIP/IP. Inclua forwarding:read para ver o destino na resposta; sem ele, forwarding é null.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"8d93a3fb-97ad-4d43-8911-5ffb1323e697"},{"name":"Encaminhar para ramal existente","id":"07d7ffb8-8990-4e39-88cc-7b110978b783","request":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\",\n \"sipAccountId\": \n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:write
Informe sipAccountId do ramal existente autorizado (inteiro 1–2147483647). Substitui o encaminhamento, sem criar ramal nem retornar senha. sipAccountId não é didId nem login SIP. Credenciais exigem endpoint próprio e validação de elegibilidade.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"ec74056f-b5ad-4a50-9c05-7205bc338e81","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\",\n \"sipAccountId\": \n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nInforme sipAccountId do ramal existente autorizado (inteiro 1–2147483647). Substitui o encaminhamento, sem criar ramal nem retornar senha. sipAccountId não é didId nem login SIP. Credenciais exigem endpoint próprio e validação de elegibilidade."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": null\n}"},{"id":"6b81e5a5-e012-4303-820c-39492d42451e","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\",\n \"sipAccountId\": \n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nInforme sipAccountId do ramal existente autorizado (inteiro 1–2147483647). Substitui o encaminhamento, sem criar ramal nem retornar senha. sipAccountId não é didId nem login SIP. Credenciais exigem endpoint próprio e validação de elegibilidade."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"50246045-a738-4b0c-8178-cc707f678ace","name":"403 account_security_review","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\",\n \"sipAccountId\": \n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nInforme sipAccountId do ramal existente autorizado (inteiro 1–2147483647). Substitui o encaminhamento, sem criar ramal nem retornar senha. sipAccountId não é didId nem login SIP. Credenciais exigem endpoint próprio e validação de elegibilidade.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"07d7ffb8-8990-4e39-88cc-7b110978b783"},{"name":"Criar/reutilizar ramal e retornar credenciais","id":"5a7771fa-4a0a-4497-aad1-3796b0f6f659","request":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:write + sip:create + sip:credentials:read
Omita sipAccountId. Os três escopos são obrigatórios. Cria/reutiliza ramal próprio exclusivo do número, configura o encaminhamento e retorna sipCredentials. Não troca a senha de ramal existente elegível. A senha é gerada, não informada pelo cliente. Guarde com segurança; não anexe respostas reais a chamados ou exemplos. Falha parcial pode deixar ramal criado; nova tentativa pode reutilizá-lo. Erros: sip_persistence_failed (503), sip_unavailable (502). Sem forwarding:read, forwarding continua null mesmo retornando credenciais.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"c71d2f2b-34fd-424e-9707-f3dad34f2137","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write` + `sip:create` + `sip:credentials:read`\n\nOmita sipAccountId. Os três escopos são obrigatórios. Cria/reutiliza ramal próprio exclusivo do número, configura o encaminhamento e retorna sipCredentials. Não troca a senha de ramal existente elegível. A senha é gerada, não informada pelo cliente. Guarde com segurança; não anexe respostas reais a chamados ou exemplos. Falha parcial pode deixar ramal criado; nova tentativa pode reutilizá-lo. Erros: sip_persistence_failed (503), sip_unavailable (502). Sem forwarding:read, forwarding continua null mesmo retornando credenciais."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": null,\n \"sipCredentials\": {\n \"username\": \"example-extension\",\n \"password\": \"EXAMPLE_NOT_A_SECRET\",\n \"server\": \"ramal.novodid.com\",\n \"port\": 5060,\n \"transport\": \"udp\",\n \"uri\": \"sip:example-extension@ramal.novodid.com\"\n }\n}"},{"id":"71c37be7-a3d8-45e6-b7b7-d2577a57caec","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write` + `sip:create` + `sip:credentials:read`\n\nOmita sipAccountId. Os três escopos são obrigatórios. Cria/reutiliza ramal próprio exclusivo do número, configura o encaminhamento e retorna sipCredentials. Não troca a senha de ramal existente elegível. A senha é gerada, não informada pelo cliente. Guarde com segurança; não anexe respostas reais a chamados ou exemplos. Falha parcial pode deixar ramal criado; nova tentativa pode reutilizá-lo. Erros: sip_persistence_failed (503), sip_unavailable (502). Sem forwarding:read, forwarding continua null mesmo retornando credenciais."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"3659257d-9674-4682-a3f2-dc4e599fcbd3","name":"403 account_security_review","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"sip\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write` + `sip:create` + `sip:credentials:read`\n\nOmita sipAccountId. Os três escopos são obrigatórios. Cria/reutiliza ramal próprio exclusivo do número, configura o encaminhamento e retorna sipCredentials. Não troca a senha de ramal existente elegível. A senha é gerada, não informada pelo cliente. Guarde com segurança; não anexe respostas reais a chamados ou exemplos. Falha parcial pode deixar ramal criado; nova tentativa pode reutilizá-lo. Erros: sip_persistence_failed (503), sip_unavailable (502). Sem forwarding:read, forwarding continua null mesmo retornando credenciais.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"5a7771fa-4a0a-4497-aad1-3796b0f6f659"},{"name":"Encaminhar para IP público","id":"7236f454-c3e6-469d-87e5-9b10bd10b820","request":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"ip\",\n \"clientIp\": \"\",\n \"clientPort\": 5060\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:write
clientIp deve ser IPv4/IPv6 público literal sob seu controle, sem protocolo, hostname, credenciais ou caminho. IPs privados, locais e reservados são recusados. clientPort é inteiro de 1 a 65535; informe a porta do seu serviço SIP (exemplo 5060). Substitui o destino. Não use IP de resolvedor DNS público como destino SIP.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"bb7152f5-54fb-4eee-a054-50e8131279c8","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"ip\",\n \"clientIp\": \"\",\n \"clientPort\": 5060\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nclientIp deve ser IPv4/IPv6 público literal sob seu controle, sem protocolo, hostname, credenciais ou caminho. IPs privados, locais e reservados são recusados. clientPort é inteiro de 1 a 65535; informe a porta do seu serviço SIP (exemplo 5060). Substitui o destino. Não use IP de resolvedor DNS público como destino SIP."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": null\n}"},{"id":"022cb002-20ef-47d2-be6e-2a8ac294318a","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"ip\",\n \"clientIp\": \"\",\n \"clientPort\": 5060\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nclientIp deve ser IPv4/IPv6 público literal sob seu controle, sem protocolo, hostname, credenciais ou caminho. IPs privados, locais e reservados são recusados. clientPort é inteiro de 1 a 65535; informe a porta do seu serviço SIP (exemplo 5060). Substitui o destino. Não use IP de resolvedor DNS público como destino SIP."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"a310c5b5-8c1a-4716-9879-ee5d8b0e8fbb","name":"403 account_security_review","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"type\": \"ip\",\n \"clientIp\": \"\",\n \"clientPort\": 5060\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:write`\n\nclientIp deve ser IPv4/IPv6 público literal sob seu controle, sem protocolo, hostname, credenciais ou caminho. IPs privados, locais e reservados são recusados. clientPort é inteiro de 1 a 65535; informe a porta do seu serviço SIP (exemplo 5060). Substitui o destino. Não use IP de resolvedor DNS público como destino SIP.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"7236f454-c3e6-469d-87e5-9b10bd10b820"},{"name":"Remover encaminhamento","id":"afbbbf03-d427-442b-abfa-87dabae95ad3","request":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"forwarding:delete
Remove a configuração de encaminhamento. Sem corpo. Não devolve o DID, não cancela assinatura nem promete excluir ramal. Chamadas podem deixar de chegar ao destino anterior. Use forwarding:read para conferir a configuração final.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","forwarding"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"96b84dfe-5631-44e0-b2b2-0dc1b9d7626c","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:delete`\n\nRemove a configuração de encaminhamento. Sem corpo. Não devolve o DID, não cancela assinatura nem promete excluir ramal. Chamadas podem deixar de chegar ao destino anterior. Use forwarding:read para conferir a configuração final."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"number\": \"5511999999999\",\n \"forwarding\": {\n \"type\": null,\n \"destination\": null\n }\n}"},{"id":"b305f6d1-2acd-45d2-82d5-de18381d6326","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:delete`\n\nRemove a configuração de encaminhamento. Sem corpo. Não devolve o DID, não cancela assinatura nem promete excluir ramal. Chamadas podem deixar de chegar ao destino anterior. Use forwarding:read para conferir a configuração final."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"77894c40-94ba-4c05-ae28-d0ede1f160d1","name":"403 account_security_review","originalRequest":{"method":"DELETE","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//forwarding","description":"## Escopos necessários\n\n`forwarding:delete`\n\nRemove a configuração de encaminhamento. Sem corpo. Não devolve o DID, não cancela assinatura nem promete excluir ramal. Chamadas podem deixar de chegar ao destino anterior. Use forwarding:read para conferir a configuração final.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"afbbbf03-d427-442b-abfa-87dabae95ad3"}],"id":"ac220c0b-2ddb-405e-ac81-cbb57ad0ec75","_postman_id":"ac220c0b-2ddb-405e-ac81-cbb57ad0ec75","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"Credenciais SIP","item":[{"name":"Consultar credenciais SIP próprias","id":"bec68b97-b3ab-4cef-9dc3-0e26ce7ff336","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//sip-credentials","description":"sip:credentials:read
Exige encaminhamento SIP ativo para ramal próprio e exclusivo do DID. Ramais compartilhados ou sem vínculo comprovado não são expostos. Retorna username, password, server, port, transport e uri. server é host SIP, não URL HTTPS. Use os dados retornados no softphone. sip_forwarding_required (409): configure encaminhamento SIP elegível. did_not_found (404): confira posse e seleção do token. Revogar o token não troca a senha SIP.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","dids","","sip-credentials"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"f8b240a0-6cf7-486e-8853-43571636cd5d","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//sip-credentials","description":"## Escopos necessários\n\n`sip:credentials:read`\n\nExige encaminhamento SIP ativo para ramal próprio e exclusivo do DID. Ramais compartilhados ou sem vínculo comprovado não são expostos. Retorna username, password, server, port, transport e uri. server é host SIP, não URL HTTPS. Use os dados retornados no softphone. sip_forwarding_required (409): configure encaminhamento SIP elegível. did_not_found (404): confira posse e seleção do token. Revogar o token não troca a senha SIP."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"didId\": 1234,\n \"sipCredentials\": {\n \"username\": \"example-extension\",\n \"password\": \"EXAMPLE_NOT_A_SECRET\",\n \"server\": \"ramal.novodid.com\",\n \"port\": 5060,\n \"transport\": \"udp\",\n \"uri\": \"sip:example-extension@ramal.novodid.com\"\n }\n}"},{"id":"ab627d79-a460-44cc-9353-70e7dc3cda54","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//sip-credentials","description":"## Escopos necessários\n\n`sip:credentials:read`\n\nExige encaminhamento SIP ativo para ramal próprio e exclusivo do DID. Ramais compartilhados ou sem vínculo comprovado não são expostos. Retorna username, password, server, port, transport e uri. server é host SIP, não URL HTTPS. Use os dados retornados no softphone. sip_forwarding_required (409): configure encaminhamento SIP elegível. did_not_found (404): confira posse e seleção do token. Revogar o token não troca a senha SIP."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"ba227ba3-0b1b-4e09-8ab2-2415eef8c79f","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/dids//sip-credentials","description":"## Escopos necessários\n\n`sip:credentials:read`\n\nExige encaminhamento SIP ativo para ramal próprio e exclusivo do DID. Ramais compartilhados ou sem vínculo comprovado não são expostos. Retorna username, password, server, port, transport e uri. server é host SIP, não URL HTTPS. Use os dados retornados no softphone. sip_forwarding_required (409): configure encaminhamento SIP elegível. did_not_found (404): confira posse e seleção do token. Revogar o token não troca a senha SIP.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"bec68b97-b3ab-4cef-9dc3-0e26ce7ff336"}],"id":"e21225a4-e499-4220-854a-2616118c0684","_postman_id":"e21225a4-e499-4220-854a-2616118c0684","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"Chamadas","item":[{"name":"Listar chamadas recebidas","id":"abc102a5-14b1-4925-bd66-0587c57a2b32","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/calls","description":"calls:read
Retorna {calls: [...]} com id, did, source, destination, startTime, duration, status e direction=\"incoming\". Filtros opcionais didId/did precisam corresponder. startDate/endDate aceitam ISO ou YYYY-MM-DD. page padrão 1 (máximo 10000); limit padrão 50 (1–200). Apenas posse atual. O filtro de janela limitada (até 500 registros) pode gerar páginas curtas/vazias; não há total global nem garantia de histórico exaustivo. Não inicia chamadas saintes.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","calls"],"host":["https://novodid.com"],"query":[{"disabled":true,"description":{"content":"ID numérico do DID próprio
\n","type":"text/plain"},"key":"didId","value":""},{"disabled":true,"description":{"content":"Telefone próprio; deve corresponder ao didId
\n","type":"text/plain"},"key":"did","value":""},{"disabled":true,"description":{"content":"Data inicial (ISO ou YYYY-MM-DD)
\n","type":"text/plain"},"key":"startDate","value":"2026-09-23"},{"disabled":true,"description":{"content":"Data final (ISO ou YYYY-MM-DD)
\n","type":"text/plain"},"key":"endDate","value":"2026-09-24"},{"disabled":true,"description":{"content":"Página 1–10000, padrão 1
\n","type":"text/plain"},"key":"page","value":"1"},{"disabled":true,"description":{"content":"1–200 registros, padrão 50
\n","type":"text/plain"},"key":"limit","value":"50"}],"variable":[]}},"response":[{"id":"c83c8e2a-69ff-4ca5-963e-fbaff0ca9f35","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/calls","host":["https://novodid.com"],"path":["api","v1","calls"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"startDate","value":"2026-09-23","description":"Data inicial (ISO ou YYYY-MM-DD)","disabled":true},{"key":"endDate","value":"2026-09-24","description":"Data final (ISO ou YYYY-MM-DD)","disabled":true},{"key":"page","value":"1","description":"Página 1–10000, padrão 1","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`calls:read`\n\nRetorna {calls: [...]} com id, did, source, destination, startTime, duration, status e direction=\"incoming\". Filtros opcionais didId/did precisam corresponder. startDate/endDate aceitam ISO ou YYYY-MM-DD. page padrão 1 (máximo 10000); limit padrão 50 (1–200). Apenas posse atual. O filtro de janela limitada (até 500 registros) pode gerar páginas curtas/vazias; não há total global nem garantia de histórico exaustivo. Não inicia chamadas saintes."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"calls\": [\n {\n \"id\": \"example-call\",\n \"did\": \"5511999999999\",\n \"source\": \"5511988888888\",\n \"destination\": \"5511999999999\",\n \"startTime\": \"2026-09-23T13:00:00.000Z\",\n \"duration\": 30,\n \"status\": \"ANSWERED\",\n \"direction\": \"incoming\"\n }\n ]\n}"},{"id":"dc3b707d-ac20-4c43-a529-67d6e8186912","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/calls","host":["https://novodid.com"],"path":["api","v1","calls"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"startDate","value":"2026-09-23","description":"Data inicial (ISO ou YYYY-MM-DD)","disabled":true},{"key":"endDate","value":"2026-09-24","description":"Data final (ISO ou YYYY-MM-DD)","disabled":true},{"key":"page","value":"1","description":"Página 1–10000, padrão 1","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`calls:read`\n\nRetorna {calls: [...]} com id, did, source, destination, startTime, duration, status e direction=\"incoming\". Filtros opcionais didId/did precisam corresponder. startDate/endDate aceitam ISO ou YYYY-MM-DD. page padrão 1 (máximo 10000); limit padrão 50 (1–200). Apenas posse atual. O filtro de janela limitada (até 500 registros) pode gerar páginas curtas/vazias; não há total global nem garantia de histórico exaustivo. Não inicia chamadas saintes."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"a30d1889-c03f-4d31-a580-9d587d150d73","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/calls","host":["https://novodid.com"],"path":["api","v1","calls"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"startDate","value":"2026-09-23","description":"Data inicial (ISO ou YYYY-MM-DD)","disabled":true},{"key":"endDate","value":"2026-09-24","description":"Data final (ISO ou YYYY-MM-DD)","disabled":true},{"key":"page","value":"1","description":"Página 1–10000, padrão 1","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`calls:read`\n\nRetorna {calls: [...]} com id, did, source, destination, startTime, duration, status e direction=\"incoming\". Filtros opcionais didId/did precisam corresponder. startDate/endDate aceitam ISO ou YYYY-MM-DD. page padrão 1 (máximo 10000); limit padrão 50 (1–200). Apenas posse atual. O filtro de janela limitada (até 500 registros) pode gerar páginas curtas/vazias; não há total global nem garantia de histórico exaustivo. Não inicia chamadas saintes.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"abc102a5-14b1-4925-bd66-0587c57a2b32"}],"id":"9a346acb-00da-42f4-94b8-c15348749f64","_postman_id":"9a346acb-00da-42f4-94b8-c15348749f64","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"SMS","item":[{"name":"Ler histórico SMS","id":"8da1f7c6-0513-46a0-a620-8c8a5ed82919","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/sms/messages","description":"sms:read
Retorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","sms","messages"],"host":["https://novodid.com"],"query":[{"disabled":true,"description":{"content":"ID numérico do DID próprio
\n","type":"text/plain"},"key":"didId","value":""},{"disabled":true,"description":{"content":"Telefone próprio; deve corresponder ao didId
\n","type":"text/plain"},"key":"did","value":""},{"disabled":true,"description":{"content":"inbound (recebido) ou outbound (enviado)
\n","type":"text/plain"},"key":"direction","value":"inbound"},{"disabled":true,"description":{"content":"1–200 registros, padrão 50
\n","type":"text/plain"},"key":"limit","value":"50"}],"variable":[]}},"response":[{"id":"38ec1947-6161-4aaf-94e5-37d54ed55e52","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/sms/messages","host":["https://novodid.com"],"path":["api","v1","sms","messages"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"direction","value":"inbound","description":"inbound (recebido) ou outbound (enviado)","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`sms:read`\n\nRetorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"messages\": [\n {\n \"id\": \"example-message\",\n \"direction\": \"inbound\",\n \"from\": \"5511988888888\",\n \"to\": \"5511999999999\",\n \"text\": \"Example message\",\n \"status\": \"received\",\n \"receivedAt\": \"2026-09-23T13:00:00.000Z\"\n }\n ]\n}"},{"id":"b35a1922-3824-43be-b464-0edb7aaac300","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/sms/messages","host":["https://novodid.com"],"path":["api","v1","sms","messages"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"direction","value":"inbound","description":"inbound (recebido) ou outbound (enviado)","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`sms:read`\n\nRetorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"d483ce4d-f6dd-4de6-8a19-4105891de523","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/sms/messages","host":["https://novodid.com"],"path":["api","v1","sms","messages"],"query":[{"key":"didId","value":"","description":"ID numérico do DID próprio","disabled":true},{"key":"did","value":"","description":"Telefone próprio; deve corresponder ao didId","disabled":true},{"key":"direction","value":"inbound","description":"inbound (recebido) ou outbound (enviado)","disabled":true},{"key":"limit","value":"50","description":"1–200 registros, padrão 50","disabled":true}]},"description":"## Escopos necessários\n\n`sms:read`\n\nRetorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"8da1f7c6-0513-46a0-a620-8c8a5ed82919"},{"name":"Enviar ou responder SMS","id":"545fc6d4-51ba-4cfd-8778-12c1a243be13","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from\": \"\",\n \"to\": \"\",\n \"text\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/sms/messages","description":"sms:send
Obrigatórios: from=seu DID autorizado com SMS, to=destinatário, text=mensagem (após trim, 1–1600 caracteres). Telefones: 10–15 dígitos, + inicial opcional. didId opcional deve corresponder a from. Para responder, use o remetente recebido em to; não há endpoint separado. Novas conversas exigem liberação da conta; conversa existente vale apenas na posse atual. 201 confirma submissão, não entrega ao aparelho. message contém id, smscMessageId (podem ser null), didId, from, to, textLength e newConversation. Sem chave de idempotência: após timeout, confira histórico antes de repetir.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","sms","messages"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"6276903d-73f1-4a35-838d-65da9b1a8445","name":"Exemplo de sucesso (fictício)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from\": \"\",\n \"to\": \"\",\n \"text\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/sms/messages","description":"## Escopos necessários\n\n`sms:send`\n\nObrigatórios: from=seu DID autorizado com SMS, to=destinatário, text=mensagem (após trim, 1–1600 caracteres). Telefones: 10–15 dígitos, + inicial opcional. didId opcional deve corresponder a from. Para responder, use o remetente recebido em to; não há endpoint separado. Novas conversas exigem liberação da conta; conversa existente vale apenas na posse atual. 201 confirma submissão, não entrega ao aparelho. message contém id, smscMessageId (podem ser null), didId, from, to, textLength e newConversation. Sem chave de idempotência: após timeout, confira histórico antes de repetir."},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": {\n \"id\": null,\n \"smscMessageId\": null,\n \"didId\": 1234,\n \"from\": \"5511999999999\",\n \"to\": \"5511988888888\",\n \"textLength\": 15,\n \"newConversation\": false\n }\n}"},{"id":"455e6aad-e42d-411d-8366-576e9707195c","name":"Formato de erro (ilustrativo)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from\": \"\",\n \"to\": \"\",\n \"text\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/sms/messages","description":"## Escopos necessários\n\n`sms:send`\n\nObrigatórios: from=seu DID autorizado com SMS, to=destinatário, text=mensagem (após trim, 1–1600 caracteres). Telefones: 10–15 dígitos, + inicial opcional. didId opcional deve corresponder a from. Para responder, use o remetente recebido em to; não há endpoint separado. Novas conversas exigem liberação da conta; conversa existente vale apenas na posse atual. 201 confirma submissão, não entrega ao aparelho. message contém id, smscMessageId (podem ser null), didId, from, to, textLength e newConversation. Sem chave de idempotência: após timeout, confira histórico antes de repetir."},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Retry-After","value":"60"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"rate_limit_exceeded\",\n \"message\": \"Limite de requisições excedido. Tente novamente mais tarde.\"\n }\n}"},{"id":"3b65a06f-cedb-4df5-b32e-b1f70f9a1712","name":"403 account_security_review","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"from\": \"\",\n \"to\": \"\",\n \"text\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/sms/messages","description":"## Escopos necessários\n\n`sms:send`\n\nObrigatórios: from=seu DID autorizado com SMS, to=destinatário, text=mensagem (após trim, 1–1600 caracteres). Telefones: 10–15 dígitos, + inicial opcional. didId opcional deve corresponder a from. Para responder, use o remetente recebido em to; não há endpoint separado. Novas conversas exigem liberação da conta; conversa existente vale apenas na posse atual. 201 confirma submissão, não entrega ao aparelho. message contém id, smscMessageId (podem ser null), didId, from, to, textLength e newConversation. Sem chave de idempotência: após timeout, confira histórico antes de repetir.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"545fc6d4-51ba-4cfd-8778-12c1a243be13"}],"id":"4f0d4383-7661-4bdb-88d2-85f4b65785cb","_postman_id":"4f0d4383-7661-4bdb-88d2-85f4b65785cb","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}},{"name":"Comprar um número","item":[{"name":"Consultar números à venda","id":"6c1d99f7-8025-48ff-be5d-c55bc0c826cb","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/catalog/dids?ddd=11&kind=fixed&limit=20&page=1","description":"Permissão: catalog:read. Consulta o estoque disponível, excluindo números vinculados e reservados. Não reserva estoque. Consulte a cotação para validar perfil, limites e condições da conta. Valores em centavos de BRL.
\nddd: dois dígitos; kind: fixed ou mobile; limit: 1–100 (padrão 20); page: 1–9999 (padrão 1). Filtros duplicados e desconhecidos são recusados.
\nbaseMonthlyAmount é o preço mensal de referência. O valor final do ciclo, descontos e taxa do cartão aparecem na cotação.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","catalog","dids"],"host":["https://novodid.com"],"query":[{"key":"ddd","value":"11"},{"key":"kind","value":"fixed"},{"key":"limit","value":"20"},{"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"7e52b636-8116-4de6-b3f0-959989efef2c","name":"Consultar números à venda","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/catalog/dids?ddd=11&kind=fixed&limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","catalog","dids"],"query":[{"key":"ddd","value":"11"},{"key":"kind","value":"fixed"},{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: catalog:read. Consulta o estoque disponível, excluindo números vinculados e reservados. Não reserva estoque. Consulte a cotação para validar perfil, limites e condições da conta. Valores em centavos de BRL.\n\nddd: dois dígitos; kind: fixed ou mobile; limit: 1–100 (padrão 20); page: 1–9999 (padrão 1). Filtros duplicados e desconhecidos são recusados.\n\nbaseMonthlyAmount é o preço mensal de referência. O valor final do ciclo, descontos e taxa do cartão aparecem na cotação."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"dids\": [\n {\n \"id\": 1234,\n \"number\": \"551130001234\",\n \"ddd\": \"11\",\n \"kind\": \"fixed\",\n \"city\": \"São Paulo\",\n \"state\": \"SP\",\n \"currency\": \"BRL\",\n \"baseMonthlyAmount\": 1499\n }\n ],\n \"page\": 1,\n \"limit\": 20,\n \"total\": 1\n}"},{"id":"1565e8f3-5cb8-44dc-9727-f6348eeab0d6","name":"403","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/catalog/dids?ddd=11&kind=fixed&limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","catalog","dids"],"query":[{"key":"ddd","value":"11"},{"key":"kind","value":"fixed"},{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: catalog:read. Consulta o estoque disponível, excluindo números vinculados e reservados. Não reserva estoque. Consulte a cotação para validar perfil, limites e condições da conta. Valores em centavos de BRL.\n\nddd: dois dígitos; kind: fixed ou mobile; limit: 1–100 (padrão 20); page: 1–9999 (padrão 1). Filtros duplicados e desconhecidos são recusados.\n\nbaseMonthlyAmount é o preço mensal de referência. O valor final do ciclo, descontos e taxa do cartão aparecem na cotação."},"status":"Forbidden","code":403,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"insufficient_scope\",\n \"message\": \"Token sem permissão para esta operação.\"\n }\n}"},{"id":"41eb9294-0ddf-44d5-964d-1a7420061970","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/catalog/dids?ddd=11&kind=fixed&limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","catalog","dids"],"query":[{"key":"ddd","value":"11"},{"key":"kind","value":"fixed"},{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: catalog:read. Consulta o estoque disponível, excluindo números vinculados e reservados. Não reserva estoque. Consulte a cotação para validar perfil, limites e condições da conta. Valores em centavos de BRL.\n\nddd: dois dígitos; kind: fixed ou mobile; limit: 1–100 (padrão 20); page: 1–9999 (padrão 1). Filtros duplicados e desconhecidos são recusados.\n\nbaseMonthlyAmount é o preço mensal de referência. O valor final do ciclo, descontos e taxa do cartão aparecem na cotação.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"6c1d99f7-8025-48ff-be5d-c55bc0c826cb"},{"name":"Cotar a compra de um número","id":"73e688e1-1153-41c2-b357-be97509050c9","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders/quote","description":"Permissão: catalog:read. Valida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.
\ncycle: monthly, semiannually ou yearly. paymentMethod: pix ou card. quantity, quando informado, deve ser 1.
\ncouponCode é opcional, com até 80 letras, números, hífen ou sublinhado.
\nAs confirmações de SMS não são necessárias para consultar a cotação. Na criação, confirme somente após o aceite real do cliente.
\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","orders","quote"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"7440fcbf-c4f0-426e-8b19-79628e764c64","name":"Cotar a compra de um número","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders/quote","description":"Permissão: catalog:read. Valida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.\n\ncycle: monthly, semiannually ou yearly. paymentMethod: pix ou card. quantity, quando informado, deve ser 1.\n\ncouponCode é opcional, com até 80 letras, números, hífen ou sublinhado.\n\nAs confirmações de SMS não são necessárias para consultar a cotação. Na criação, confirme somente após o aceite real do cliente."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"did\": {\n \"id\": 1234,\n \"number\": \"551130001234\",\n \"kind\": \"fixed\",\n \"smsEnabled\": false\n },\n \"quantity\": 1,\n \"paymentMethod\": \"pix\",\n \"pricing\": {\n \"currency\": \"BRL\",\n \"baseMonthlyAmount\": 1499,\n \"cycle\": \"monthly\",\n \"cycleMonths\": 1,\n \"subtotalAmount\": 1499,\n \"totalDiscountPercent\": 0,\n \"discountedAmount\": 1499,\n \"cardFeeAmount\": 0,\n \"totalAmount\": 1499\n },\n \"recurring\": true,\n \"reserved\": false,\n \"acknowledgements\": {\n \"fixedDidSms\": {\n \"required\": true,\n \"message\": \"Confirme que está ciente de que este número fixo não recebe SMS antes de assinar.\"\n },\n \"mobileMonthlySms\": {\n \"required\": false,\n \"message\": null\n }\n }\n}"},{"id":"8c4db2f7-9ee4-4894-9934-f49625630bba","name":"409","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders/quote","description":"Permissão: catalog:read. Valida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.\n\ncycle: monthly, semiannually ou yearly. paymentMethod: pix ou card. quantity, quando informado, deve ser 1.\n\ncouponCode é opcional, com até 80 letras, números, hífen ou sublinhado.\n\nAs confirmações de SMS não são necessárias para consultar a cotação. Na criação, confirme somente após o aceite real do cliente."},"status":"Conflict","code":409,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"did_unavailable\",\n \"message\": \"Número indisponível para compra.\"\n }\n}"},{"id":"7ca06360-e4e1-434c-91ba-fe760466204d","name":"403 account_security_review","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders/quote","description":"Permissão: catalog:read. Valida os requisitos da conta e calcula uma assinatura de um DID. Não cria cobrança nem reserva o número. Apresente preço, recorrência e condições de SMS ao cliente antes de criar o pedido.\n\ncycle: monthly, semiannually ou yearly. paymentMethod: pix ou card. quantity, quando informado, deve ser 1.\n\ncouponCode é opcional, com até 80 letras, números, hífen ou sublinhado.\n\nAs confirmações de SMS não são necessárias para consultar a cotação. Na criação, confirme somente após o aceite real do cliente.\n\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"73e688e1-1153-41c2-b357-be97509050c9"},{"name":"Criar pagamento de um número","id":"b8cb3baa-ebe4-4c84-babc-e0674563ec59","request":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.
\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.
\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.
\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.
\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.
\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.
\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.
\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.
\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\nHTTP 409 did_number_unavailable: não foi possível confirmar o telefone selecionado antes de criar o pagamento. Consulte o pedido indicado em error.details.orderId e atualize o catálogo antes de uma nova tentativa; não repita uma cobrança sem conferir o pedido anterior.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","orders"],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"58c0a93e-b3ab-4c69-8e1c-7ffc7dbc3848","name":"Criar pagamento de um número","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas."},"status":"Created","code":201,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"order\": {\n \"id\": \"11111111-1111-4111-8111-111111111111\",\n \"didId\": 1234,\n \"quantity\": 1,\n \"status\": \"awaiting_payment\",\n \"paymentMethod\": \"pix\",\n \"currency\": \"BRL\",\n \"amount\": 1499,\n \"createdAt\": \"2026-09-23T15:00:00.000Z\",\n \"expiresAt\": \"2026-09-23T15:15:00.000Z\",\n \"checkoutUrl\": null,\n \"pix\": {\n \"copyPaste\": \"PIX_COPY_AND_PASTE_EXAMPLE\",\n \"qrCodeDataUrl\": \"data:image/png;base64,EXAMPLE\"\n }\n }\n}"},{"id":"84920185-3473-4736-b02a-6f773bed1a6c","name":"409","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas."},"status":"Conflict","code":409,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"checkout_in_progress\",\n \"message\": \"Este número já tem um pedido pendente. A reserva dura até 15 minutos. Você pode escolher outro número.\"\n }\n}"},{"id":"af384ff2-0840-40d5-9052-e2f3f1dfb241","name":"409 checkout_initializing","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas."},"status":"Conflict","code":409,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"checkout_initializing\",\n \"message\": \"Outra compra está sendo preparada. Tente novamente em instantes.\"\n }\n}"},{"id":"6a3087b9-19ca-4a44-917d-56e204f4c950","name":"409 order_expired","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas."},"status":"Conflict","code":409,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"order_expired\",\n \"message\": \"O prazo deste pedido terminou. Consulte o pedido antes de tentar novamente.\",\n \"details\": {\n \"orderId\": \"11111111-1111-4111-8111-111111111111\"\n }\n }\n}"},{"id":"7f52e405-6d9a-4206-8daa-fbd7fd012e0b","name":"403 account_security_review","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"},{"id":"3ade5260-e92b-4073-ba23-44f7bddbd4da","name":"409 did_number_unavailable","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"Idempotency-Key","value":""}],"body":{"mode":"raw","raw":"{\n \"didId\": 1234,\n \"quantity\": 1,\n \"cycle\": \"monthly\",\n \"paymentMethod\": \"pix\",\n \"fixedDidSmsAcknowledged\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://novodid.com/api/v1/orders","description":"Permissão: orders:create. Cria um pedido de exatamente um DID. Pix retorna copia e cola e imagem QR; cartão retorna checkoutUrl para o cliente concluir a assinatura. Exige Idempotency-Key no cabeçalho. Criar o pedido não significa pagamento confirmado ou número ativado.\n\nIdempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e reutilize a mesma chave e o mesmo corpo nas repetições. Outra compra precisa de outra chave.\n\nA reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. A mesma chave com dados diferentes retorna 409 idempotency_conflict. Em timeout, consulte o pedido ou repita a mesma chave; não gere outra cobrança.\n\nFixos exigem fixedDidSmsAcknowledged=true. Planos móveis sem SMS exigem mobileMonthlySmsAcknowledged=true quando indicado na cotação. Não aceite essas condições automaticamente em nome do cliente.\n\nPara comprar, use um token sem restrição a posses de números existentes. O escopo não permite usar cartão salvo nem efetuar pagamento sem ação do cliente.\n\nA reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.\n\nEm ofertas temporárias de números móveis, os ciclos disponíveis e a inclusão de SMS podem variar. Consulte sempre a cotação: did.smsEnabled informa se o plano inclui SMS, e acknowledgements.mobileMonthlySms.required indica se é necessário enviar mobileMonthlySmsAcknowledged=true após o aceite do cliente. Apesar do nome, esses campos se aplicam a qualquer ciclo móvel sem SMS. A cotação não garante a oferta; as condições são conferidas novamente ao criar o pagamento. Pagamentos emitidos durante a oferta preservam suas condições até a validade do próprio pagamento. Após o encerramento, novas compras seguem as condições vigentes, e contratações concluídas mantêm seu ciclo e a condição de SMS nas renovações enquanto permanecerem vigentes. Isso não representa garantia de preço. Conta apta, verificação, limites, estoque disponível e um número por pedido continuam obrigatórios.\n\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.\n\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.\n\nHTTP 409 did_number_unavailable: não foi possível confirmar o telefone selecionado antes de criar o pagamento. Consulte o pedido indicado em error.details.orderId e atualize o catálogo antes de uma nova tentativa; não repita uma cobrança sem conferir o pedido anterior."},"status":"Conflict","code":409,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"did_number_unavailable\",\n \"message\": \"Não foi possível confirmar o número selecionado. Atualize a lista e tente novamente.\",\n \"details\": {\n \"orderId\": \"11111111-1111-4111-8111-111111111111\"\n }\n }\n}"}],"_postman_id":"b8cb3baa-ebe4-4c84-babc-e0674563ec59"},{"name":"Consultar um pedido","id":"3ab9883a-bcd5-49d3-a2a7-cf2fd8dd044d","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/orders/","description":"Permissão: orders:read. Consulta apenas pedidos da conta autenticada. Substitua {orderId} pelo UUID retornado na criação. Retorna as instruções de pagamento enquanto o pedido aguarda pagamento. Pedido de outra conta retorna 404.
\nEstados: creating (criando), awaiting_payment (aguardando pagamento), paid (pago, aguardando ativação), active (ativação realizada), expired, cancelled, refunded, rejected ou review_required.
\npaid e active são estados diferentes. Consulte também /api/v1/dids para confirmar a posse ativa atual. O pedido mantém o histórico da compra.
\nA confirmação vale somente para o pagamento associado ao pedido consultado. Gerar o QR Code ou autorizar a recorrência não significa que o pagamento foi concluído. Se o banco mostrar pagamento concluído e o pedido continuar aguardando, consulte o mesmo pedido e contate o suporte com seu ID; não pague novamente.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","orders",""],"host":["https://novodid.com"],"query":[],"variable":[]}},"response":[{"id":"fafcf71a-14f3-4b46-9571-faa997dd3ab9","name":"Consultar um pedido","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/orders/","description":"Permissão: orders:read. Consulta apenas pedidos da conta autenticada. Substitua {orderId} pelo UUID retornado na criação. Retorna as instruções de pagamento enquanto o pedido aguarda pagamento. Pedido de outra conta retorna 404.\n\nEstados: creating (criando), awaiting_payment (aguardando pagamento), paid (pago, aguardando ativação), active (ativação realizada), expired, cancelled, refunded, rejected ou review_required.\n\npaid e active são estados diferentes. Consulte também /api/v1/dids para confirmar a posse ativa atual. O pedido mantém o histórico da compra."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"order\": {\n \"id\": \"11111111-1111-4111-8111-111111111111\",\n \"didId\": 1234,\n \"quantity\": 1,\n \"status\": \"awaiting_payment\",\n \"paymentMethod\": \"pix\",\n \"currency\": \"BRL\",\n \"amount\": 1499,\n \"createdAt\": \"2026-09-23T15:00:00.000Z\",\n \"expiresAt\": \"2026-09-23T15:15:00.000Z\",\n \"checkoutUrl\": null,\n \"pix\": {\n \"copyPaste\": \"PIX_COPY_AND_PASTE_EXAMPLE\",\n \"qrCodeDataUrl\": \"data:image/png;base64,EXAMPLE\"\n }\n }\n}"},{"id":"abd2ddea-a670-4e0c-bc5d-97a5310edce3","name":"404","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/orders/","description":"Permissão: orders:read. Consulta apenas pedidos da conta autenticada. Substitua {orderId} pelo UUID retornado na criação. Retorna as instruções de pagamento enquanto o pedido aguarda pagamento. Pedido de outra conta retorna 404.\n\nEstados: creating (criando), awaiting_payment (aguardando pagamento), paid (pago, aguardando ativação), active (ativação realizada), expired, cancelled, refunded, rejected ou review_required.\n\npaid e active são estados diferentes. Consulte também /api/v1/dids para confirmar a posse ativa atual. O pedido mantém o histórico da compra."},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"order_not_found\",\n \"message\": \"Pedido não encontrado.\"\n }\n}"},{"id":"f35a0506-9b38-4f65-bf62-dbee1b3ecb7a","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/orders/","description":"Permissão: orders:read. Consulta apenas pedidos da conta autenticada. Substitua {orderId} pelo UUID retornado na criação. Retorna as instruções de pagamento enquanto o pedido aguarda pagamento. Pedido de outra conta retorna 404.\n\nEstados: creating (criando), awaiting_payment (aguardando pagamento), paid (pago, aguardando ativação), active (ativação realizada), expired, cancelled, refunded, rejected ou review_required.\n\npaid e active são estados diferentes. Consulte também /api/v1/dids para confirmar a posse ativa atual. O pedido mantém o histórico da compra.\n\nA confirmação vale somente para o pagamento associado ao pedido consultado. Gerar o QR Code ou autorizar a recorrência não significa que o pagamento foi concluído. Se o banco mostrar pagamento concluído e o pedido continuar aguardando, consulte o mesmo pedido e contate o suporte com seu ID; não pague novamente.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"3ab9883a-bcd5-49d3-a2a7-cf2fd8dd044d"},{"name":"Listar pedidos da conta","id":"19a25889-e25c-4f8c-acd8-1a2c44d342b6","request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://novodid.com/api/v1/orders?limit=20&page=1","description":"Permissão: orders:read. Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.
\nlimit: 1–100, padrão 20; page: 1–9999, padrão 1. Uma página vazia indica o fim da lista.
\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}},"urlObject":{"path":["api","v1","orders"],"host":["https://novodid.com"],"query":[{"key":"limit","value":"20"},{"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"6fc1b676-3c68-41e0-8d53-a5279ac98e77","name":"Listar pedidos da conta","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/orders?limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","orders"],"query":[{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: orders:read. Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.\n\nlimit: 1–100, padrão 20; page: 1–9999, padrão 1. Uma página vazia indica o fim da lista."},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"orders\": [\n {\n \"id\": \"11111111-1111-4111-8111-111111111111\",\n \"didId\": 1234,\n \"quantity\": 1,\n \"status\": \"awaiting_payment\",\n \"paymentMethod\": \"pix\",\n \"currency\": \"BRL\",\n \"amount\": 1499,\n \"createdAt\": \"2026-09-23T15:00:00.000Z\",\n \"expiresAt\": \"2026-09-23T15:15:00.000Z\",\n \"checkoutUrl\": null,\n \"pix\": {\n \"copyPaste\": \"PIX_COPY_AND_PASTE_EXAMPLE\",\n \"qrCodeDataUrl\": \"data:image/png;base64,EXAMPLE\"\n }\n }\n ],\n \"page\": 1,\n \"limit\": 20\n}"},{"id":"ec4d1d86-4c19-44f9-9ec0-bd4988cd1b7e","name":"403","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/orders?limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","orders"],"query":[{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: orders:read. Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.\n\nlimit: 1–100, padrão 20; page: 1–9999, padrão 1. Uma página vazia indica o fim da lista."},"status":"Forbidden","code":403,"_postman_previewlanguage":"Text","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"insufficient_scope\",\n \"message\": \"Token sem permissão para esta operação.\"\n }\n}"},{"id":"cc787d04-6bc0-4c27-8565-36d6e206114d","name":"403 account_security_review","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://novodid.com/api/v1/orders?limit=20&page=1","host":["https://novodid.com"],"path":["api","v1","orders"],"query":[{"key":"limit","value":"20"},{"key":"page","value":"1"}]},"description":"Permissão: orders:read. Lista os pedidos da conta por data, do mais recente ao mais antigo. Aceita apenas paginação.\n\nlimit: 1–100, padrão 20; page: 1–9999, padrão 1. Uma página vazia indica o fim da lista.\n\nQuando a conta estiver em análise de segurança, consultas e operações são bloqueadas com HTTP 403 e código account_security_review, inclusive com tokens já emitidos. Não tente contornar a restrição ou repetir automaticamente. O acesso retorna após liberação administrativa; outros limites e restrições continuam aplicáveis. Webhooks pendentes e eventos do período são suprimidos sem reenvio automático. Cobranças, vencimentos e expiração seguem as regras existentes. Acompanhe a análise em https://novodid.com/seguranca/atendimento. Durante o bloqueio, somente o chamado de segurança vinculado à análise permite leitura, respostas e anexos pelo site autenticado; outros chamados e a API pública continuam indisponíveis. O cliente aguarda o primeiro contato da equipe e pode enviar uma única resposta a cada nova mensagem do suporte, incluindo os anexos solicitados."},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Cache-Control","value":"no-store"}],"cookie":[],"responseTime":null,"body":"{\n \"error\": {\n \"code\": \"account_security_review\",\n \"message\": \"Estamos realizando verificações de segurança relacionadas à sua conta, às compras e à documentação cadastrada. Durante essa análise, o acesso às funcionalidades e a realização e o recebimento de novas chamadas ficam temporariamente suspensos. Acompanhe a análise e converse com nossa equipe pelo chamado de segurança. Se precisarmos de informações adicionais, faremos a solicitação por lá e avisaremos pelo e-mail cadastrado.\"\n }\n}"}],"_postman_id":"19a25889-e25c-4f8c-acd8-1a2c44d342b6"}],"id":"d862fe0d-794a-455f-ac96-c3fc70b4fae0","description":"Permissões: catalog:read consulta estoque e cotação; orders:create cria pedidos; orders:read consulta e lista pedidos da conta. Tokens existentes não recebem essas permissões automaticamente. Para comprar, o token deve permitir todos os números, sem restrição a posses existentes. A conta precisa estar ativa, autorizada a comprar, com verificação exigida concluída e capacidade disponível. Valem as mesmas regras de móveis, ciclos e SMS do painel.
\nCada pedido contém exatamente um DID. quantity pode ser omitido ou informado como o inteiro 1; listas e compras em lote são recusadas. A reserva pendente vale somente para o DID escolhido e dura no máximo 15 minutos desde a criação do pedido. Outros DIDs podem ser comprados durante esse período, respeitando os limites da conta. Ciclos: mensal, semestral e anual. Valores em centavos de BRL, calculados pelo servidor. O catálogo informa o preço mensal de referência; a cotação inclui ciclo, descontos e taxa do cartão. Cotar não reserva o número.
\nApresente número, ciclo, valor recorrente e condições de SMS ao cliente. Somente após o aceite envie fixedDidSmsAcknowledged=true para fixos, ou mobileMonthlySmsAcknowledged=true quando exigido na cotação. O agente não deve presumir o consentimento do cliente.
\nPOST /api/v1/orders exige o cabeçalho Idempotency-Key: 16–128 letras, números, hífen ou sublinhado. Gere uma chave para cada nova intenção de compra e mantenha chave/corpo nas repetições. Alterar os dados com a mesma chave retorna 409 idempotency_conflict. Após timeout, consulte o pedido ou repita a mesma chave; não gere outra para contornar a falha. O erro pode informar details.orderId.
\nPix Automático retorna pix.copyPaste e pix.qrCodeDataUrl. Confira no aplicativo bancário o pagamento e a autorização recorrente. Cartão retorna checkoutUrl para o cliente concluir o pagamento. Criar o pedido não paga nem ativa o DID. O retorno do navegador não confirma o pagamento.
\nEstados do pedido: creating, awaiting_payment, paid (pago, aguardando ativação), active (ativação concluída), expired, cancelled, refunded, rejected e review_required. Consulte o pedido para acompanhar e /api/v1/dids para conferir a posse ativa atual. As instruções de pagamento aparecem apenas em awaiting_payment. A reserva pendente expira em até 15 minutos, inclusive se a criação falhar ou o pedido precisar de análise. Isso não confirma cancelamento externo instantâneo nem reembolso. Não pague instruções vencidas; um pagamento confirmado após a expiração será analisado sem substituir outra reserva ou posse. Pagamentos já confirmados e números ativos continuam protegidos. Em review_required, contate o suporte com o ID do pedido.
\nMCP remoto: https://mcp.novodid.com/mcp, transporte Streamable HTTP e o mesmo token Bearer da API NovoDID. Ferramentas: search_available_dids, quote_did_purchase, create_did_checkout, get_did_order e list_did_orders. A listagem respeita as permissões do token. create_did_checkout recebe idempotencyKey nos argumentos. Pix retorna copia e cola, imagem PNG e terminalQr para fonte monoespaçada. Se o cliente não exibir imagens, use o texto exato de copia e cola. O cliente MCP precisa permitir configurar o token Bearer.
\n409 checkout_initializing indica que outra compra da conta ainda está sendo preparada. Aguarde alguns instantes e repita com a mesma Idempotency-Key e o mesmo corpo. Essa espera ocorre somente na criação, não durante os 15 minutos para pagamento.
\n409 order_expired indica que a resposta de criação chegou após o prazo do pedido. Nenhum QR Code ou link vencido é entregue. Consulte details.orderId antes de iniciar outra compra e não pague instruções antigas.
\n","_postman_id":"d862fe0d-794a-455f-ac96-c3fc70b4fae0","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"977d3f09-0c15-4392-b897-06032f40645b","id":"977d3f09-0c15-4392-b897-06032f40645b","name":"NovoDID API pública — Português (Brasil)","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"variable":[{"key":"baseUrl","value":"https://novodid.com","type":"string"},{"key":"novodid_token","value":"","type":"string"},{"key":"didId","value":"","type":"string"},{"key":"didNumber","value":"","type":"string"},{"key":"destinationNumber","value":"","type":"string"},{"key":"sipAccountId","value":"","type":"string"},{"key":"clientIp","value":"","type":"string"},{"key":"recipientNumber","value":"","type":"string"},{"key":"smsText","value":"","type":"string"},{"key":"orderId","value":"","type":"string"},{"key":"idempotencyKey","value":"","type":"string"}]}