{"openapi":"3.1.0","info":{"title":"Nock API","version":"0.1.0","description":"API inicial da Nock para busca, enriquecimento e automações de dados. Use uma chave criada na página API do painel. Operações cobradas usam o saldo do mesmo workspace."},"servers":[{"url":"https://api.usenock.com","description":"API da Nock"}],"tags":[{"name":"Catálogo"},{"name":"Busca"},{"name":"Enriquecimento"},{"name":"IA"},{"name":"Prospecção"},{"name":"Créditos"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"nock_live_…","description":"Chave Nock enviada em Authorization: Bearer <chave>."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}}}}},"security":[{"bearerAuth":[]}],"paths":{"/health":{"get":{"tags":["Catálogo"],"summary":"Verificar disponibilidade","security":[],"responses":{"200":{"description":"API disponível","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"status":"ok"}}}}}}},"/api/providers":{"get":{"tags":["Catálogo"],"summary":"Listar provedores e campos disponíveis","security":[],"responses":{"200":{"description":"Catálogo atual de provedores e enriquecimentos","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/sourcing/people":{"post":{"tags":["Busca"],"summary":"Buscar pessoas","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jobTitle":{"type":"string"},"seniorities":{"type":"array","items":{"type":"string"}},"roles":{"type":"array","items":{"type":"string"}},"companySizes":{"type":"array","items":{"type":"string"}},"company":{"type":"string"},"domain":{"type":"string"},"industry":{"type":"string"},"personIndustry":{"type":"string"},"skills":{"type":"string"},"location":{"type":"string"},"companyLocation":{"type":"string"},"revenueRange":{"type":"string"},"technologies":{"type":"array","items":{"type":"string"}},"emailStatuses":{"type":"array","items":{"type":"string","enum":["verified","likely to engage","unverified","unavailable"]}},"language":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":25},"sourceOrder":{"type":"array","items":{"type":"string"}}}},"example":{"jobTitle":"Head of Sales","location":"São Paulo","limit":10}}}},"responses":{"200":{"description":"Pessoas encontradas","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/companies/search":{"post":{"tags":["Busca"],"summary":"Buscar empresas","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"industry":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"sizes":{"type":"array","items":{"type":"string"}},"location":{"type":"string"},"cnaes":{"type":"array","items":{"type":"string"}},"registrationStatuses":{"type":"array","items":{"type":"string","enum":["ATIVA","BAIXADA","INAPTA","NULA","SUSPENSA"]}},"establishmentTypes":{"type":"array","items":{"type":"string","enum":["MATRIZ","FILIAL"]}},"fiscalSizes":{"type":"array","items":{"type":"string","enum":["01","02","03","05"]}},"capitalMin":{"type":"number","minimum":0},"capitalMax":{"type":"number","minimum":0},"legalNatureCodes":{"type":"array","items":{"type":"string"}},"partnerName":{"type":"string"},"partnerDocument":{"type":"string"},"simpleOption":{"type":"boolean"},"openingDateMin":{"type":"string","format":"date"},"openingDateMax":{"type":"string","format":"date"},"hasPhone":{"type":"boolean"},"hasEmail":{"type":"boolean"},"state":{"type":"string","minLength":2,"maxLength":2},"city":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":20},"companyOrder":{"type":"array","items":{"type":"string"}}}},"example":{"keywords":["autopeças"],"registrationStatuses":["ATIVA"],"legalNatureCodes":["2062"],"simpleOption":true,"openingDateMin":"2020-01-01","hasPhone":true,"state":"PR","city":"Curitiba","limit":10}}}},"responses":{"200":{"description":"Empresas encontradas","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/companies/cnpj/batch":{"post":{"tags":["Busca"],"summary":"Consultar empresas por CNPJ em lote","description":"Hidrata de 1 a 500 CNPJs preservando a primeira ocorrência e informa separadamente quais documentos válidos não foram encontrados. CNPJs inválidos geram erro 400 e nunca são tratados como empresa ausente.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cnpjs"],"properties":{"cnpjs":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"string"}}}},"example":{"cnpjs":["04.447.476/0001-26","01.245.502/0001-45"]}}}},"responses":{"200":{"description":"Empresas consultadas","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"results":[{"cnpj":"04447476000126","name":"ESTAMPARIA DE METAIS EBENEZER","source":"Nock Registry"}],"notFound":["01245502000145"],"invalid":[]}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/enrich":{"post":{"tags":["Enriquecimento"],"summary":"Enriquecer uma pessoa ou empresa","description":"Envie ao menos um identificador. goalFields limita os campos desejados; providerOrder é opcional.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email"},"personalEmail":{"type":"string","format":"email"},"linkedinUrl":{"type":"string","format":"uri"},"phone":{"type":"string"},"fullName":{"type":"string"},"companyName":{"type":"string"},"companyDomain":{"type":"string"},"cnpj":{"type":"string"},"goalFields":{"type":"array","items":{"type":"string"}},"providerOrder":{"type":"array","items":{"type":"string"}},"onlyListed":{"type":"boolean"}}},"example":{"fullName":"Ada Lovelace","companyDomain":"example.com","goalFields":["work_email"]}}}},"responses":{"200":{"description":"Registro enriquecido","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/research":{"post":{"tags":["IA"],"summary":"Pesquisar um registro na web","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string"},"name":{"type":"string"},"company":{"type":"string"},"companyDomain":{"type":"string"},"website":{"type":"string"},"linkedinUrl":{"type":"string"},"webSearch":{"type":"boolean"},"columns":{"type":"array","items":{"type":"object","required":["id","label","value"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"value":{"type":"string"}}}}}},"example":{"prompt":"Resuma em uma frase o que a empresa faz.","company":"Nock","companyDomain":"usenock.com","webSearch":true}}}},"responses":{"200":{"description":"Resultado determinístico da pesquisa","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/ai-column":{"post":{"tags":["IA"],"summary":"Gerar um valor de coluna com IA","description":"instruction é obrigatória. As demais propriedades string são usadas como contexto.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["instruction"],"properties":{"instruction":{"type":"string"}},"additionalProperties":{"type":"string"}},"example":{"instruction":"Classifique como Enterprise, Mid-market ou SMB.","company":"Acme","employees":"480"}}}},"responses":{"200":{"description":"Valor gerado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"value":"Mid-market"}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"429":{"description":"Limite de requisições excedido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/templates":{"get":{"tags":["Prospecção"],"summary":"Listar templates de prospecção","description":"Configurações reutilizáveis de oferta, remetente, tom e contexto da empresa. Não consome créditos.","responses":{"200":{"description":"Templates do workspace","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"post":{"tags":["Prospecção"],"summary":"Criar ou atualizar um template pelo nome","description":"Salvar com um nome já existente atualiza aquele template em vez de duplicá-lo. Não consome créditos.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","offering"],"properties":{"name":{"type":"string","maxLength":120},"campaignName":{"type":"string","maxLength":120},"offering":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":120},"tone":{"type":"string","maxLength":200},"businessContext":{"type":"string","maxLength":20000},"language":{"type":"string","maxLength":80}}},"example":{"name":"Padrão Nock","offering":"Enriquecimento de dados B2B com cascata de provedores","senderName":"Ana","tone":"direto e consultivo","language":"Português (Brasil)"}}}},"responses":{"201":{"description":"Template salvo","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/templates/{templateId}":{"patch":{"tags":["Prospecção"],"summary":"Atualizar um template","description":"Única forma de renomear um template. Campos omitidos mantêm o valor atual. Não consome créditos.","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id do template."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"campaignName":{"type":"string","maxLength":120},"offering":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":120},"tone":{"type":"string","maxLength":200},"businessContext":{"type":"string","maxLength":20000},"language":{"type":"string","maxLength":80}}},"example":{"tone":"direto e consultivo"}}}},"responses":{"200":{"description":"Template atualizado","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Template não encontrado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"Já existe um template com esse nome","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"delete":{"tags":["Prospecção"],"summary":"Excluir um template","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id do template."}],"responses":{"200":{"description":"Template excluído","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"deleted":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Template não encontrado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/campaigns":{"get":{"tags":["Prospecção"],"summary":"Listar campanhas de prospecção","description":"Cada campanha traz o total de prospecções por etapa do pipeline.","responses":{"200":{"description":"Campanhas do workspace","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"post":{"tags":["Prospecção"],"summary":"Criar uma campanha de prospecção","description":"Cria um rascunho com nome e oferta. Opcionalmente gera uma mensagem personalizada por linha selecionada de uma planilha de pessoas, usando os rótulos das colunas como contexto. A configuração pode vir de um templateId, dos campos enviados ou de ambos (os campos enviados prevalecem). A geração de campanhas e cadências não consome créditos; busca e enriquecimento prévios seguem suas próprias regras.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","offering"],"properties":{"sheetId":{"type":"string","format":"uuid"},"rowIds":{"type":"array","maxItems":25,"items":{"type":"string"}},"templateId":{"type":"string","format":"uuid"},"name":{"type":"string","maxLength":120},"offering":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":120},"tone":{"type":"string","maxLength":200},"businessContext":{"type":"string","maxLength":20000},"language":{"type":"string","maxLength":80}}},"example":{"name":"Fintechs SP","offering":"Enriquecimento de dados B2B"}}}},"responses":{"201":{"description":"Prospecção criada","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"campaignId":"0f5b3b3e-8a1f-4a67-9d0d-2b6f5f0f1a11","campaignName":"Fintechs SP","created":2}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Planilha ou template não encontrado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/campaigns/{campaignId}":{"get":{"tags":["Prospecção"],"summary":"Detalhar uma campanha e suas prospecções","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da campanha."}],"responses":{"200":{"description":"Campanha e prospecções","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Campanha não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"patch":{"tags":["Prospecção"],"summary":"Atualizar nome, oferta ou contexto de uma campanha","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da campanha."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"offering":{"type":"string","maxLength":2000},"senderName":{"type":"string","maxLength":120},"tone":{"type":"string","maxLength":200},"businessContext":{"type":"string","maxLength":20000}}},"example":{"offering":"Enriquecimento de dados B2B para fintechs","tone":"consultative"}}}},"responses":{"200":{"description":"Campanha atualizada","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Campanha não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/campaigns/{campaignId}/prospects":{"post":{"tags":["Prospecção"],"summary":"Adicionar pessoas a uma campanha","description":"Gera mensagens para até 25 pessoas de uma planilha e as vincula à campanha. Linhas já presentes são ignoradas. Não consome créditos.","parameters":[{"name":"campaignId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da campanha."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sheetId","rowIds"],"properties":{"sheetId":{"type":"string","format":"uuid"},"rowIds":{"type":"array","minItems":1,"maxItems":25,"items":{"type":"string"}}}},"example":{"sheetId":"0f5b3b3e-8a1f-4a67-9d0d-2b6f5f0f1a11","rowIds":["row-1","row-2"]}}}},"responses":{"201":{"description":"Pessoas adicionadas","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"ok":true,"added":2,"skipped":0}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"402":{"description":"Saldo de créditos insuficiente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Campanha ou planilha não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"409":{"description":"Campanha já cheia","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/prospects":{"get":{"tags":["Prospecção"],"summary":"Listar prospecções","parameters":[{"name":"campaignId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Filtra por campanha."},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["ready","sending","awaiting_reply","replied","paused","failed"]},"description":"Filtra por etapa do pipeline."}],"responses":{"200":{"description":"Prospecções do workspace","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/prospects/{prospectId}":{"get":{"tags":["Prospecção"],"summary":"Detalhar uma prospecção","parameters":[{"name":"prospectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da prospecção."}],"responses":{"200":{"description":"Prospecção com mensagem completa e contexto","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Prospecção não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"patch":{"tags":["Prospecção"],"summary":"Atualizar etapa ou mensagem de uma prospecção","description":"Editar a mensagem não regenera nada e não consome créditos.","parameters":[{"name":"prospectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da prospecção."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ready","sending","awaiting_reply","replied","paused","failed"]},"connectionNote":{"type":"string","maxLength":300},"emailSubject":{"type":"string","maxLength":300},"emailBody":{"type":"string","maxLength":5000}}},"example":{"status":"awaiting_reply"}}}},"responses":{"200":{"description":"Prospecção atualizada","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Erro da requisição","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Prospecção não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}},"delete":{"tags":["Prospecção"],"summary":"Excluir uma prospecção","description":"Remove a pessoa, a mensagem e o histórico. A campanha permanece mesmo se ficar sem pessoas.","parameters":[{"name":"prospectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da prospecção."}],"responses":{"200":{"description":"Prospecção excluída","content":{"application/json":{"schema":{"type":"object","additionalProperties":true},"example":{"deleted":true,"campaignDeleted":false}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Prospecção não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/prospecting/prospects/{prospectId}/events":{"get":{"tags":["Prospecção"],"summary":"Histórico de uma prospecção","parameters":[{"name":"prospectId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Id da prospecção."}],"responses":{"200":{"description":"Eventos em ordem cronológica","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Prospecção não encontrada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/credits":{"get":{"tags":["Créditos"],"summary":"Consultar saldo e consumo","responses":{"200":{"description":"Saldo, totais e movimentos recentes","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"401":{"description":"Chave ausente, inválida ou revogada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}