Documentação da API cid

GET /v1/cid10/{codigo} Free+

Detalhe de um código CID-10: descrição e hierarquia completa (capítulo, grupo, categoria).

Parâmetros (path)

• codigo — código CID-10, com ou sem ponto (ex.: A00 ou A15.0)

Exemplo de resposta

{
  "codigo": "A00",
  "descricao": "Cólera",
  "capitulo": "I",
  "capituloDesc": "Algumas doenças infecciosas e parasitárias",
  "grupo": "A00-A09",
  "grupoDesc": "Doenças infecciosas intestinais",
  "categoria": "A00",
  "categoriaDesc": "Cólera",
  "tipo": "categoria",
  "referenciaDados": "2026-07-11T00:03:28.792Z"
}

Retorna 400 parametro_invalido se o código não seguir o padrão CID-10 e 404 nao_encontrado quando o código não consta na base vigente.

GET /v1/cid11/{codigo} Free+

Detalhe de um código CID-11 (OMS): descrição, bloco e capítulo.

Parâmetros (path)

• codigo — código CID-11 (ex.: 1A00)

Exemplo curl

curl -H "X-API-Key: SUA_KEY" \
  "https://southamerica-east1-no-api-br.cloudfunctions.net/apiCid/v1/cid11/1A00"

Exemplo de resposta

{
  "codigo": "1A00",
  "descricao": "Cólera",
  "bloco": "BlockL2-1A0",
  "blocoDesc": "Infecções intestinais bacterianas",
  "capitulo": "01",
  "capituloDesc": "Algumas doenças infecciosas ou parasitárias",
  "tipo": "categoria",
  "referenciaDados": "2026-07-11T00:03:28.792Z"
}

Retorna 400 parametro_invalido se o código não seguir o padrão CID-11 e 404 nao_encontrado quando o código não consta na base vigente.

GET /v1/busca?q=&pagina= Pro+

Busca textual (accent/case-insensitive) na descrição dos códigos CID-10 e CID-11 simultaneamente. Resposta paginada (20 por página).

Parâmetros (query)

• q — termo de busca, mínimo 2 caracteres (ex.: colera)
• pagina — página do resultado, começa em 1 (opcional)

Exemplo curl

curl -H "X-API-Key: SUA_KEY" \
  "https://southamerica-east1-no-api-br.cloudfunctions.net/apiCid/v1/busca?q=colera&pagina=1"

Exemplo de resposta

{
  "total": 2,
  "pagina": 1,
  "totalPaginas": 1,
  "porPagina": 20,
  "referenciaDados": "2026-07-11T00:03:28.792Z",
  "resultados": [
    {
      "versao": 10,
      "codigo": "A00",
      "descricao": "Cólera",
      "capitulo": "I",
      "capituloDesc": "Algumas doenças infecciosas e parasitárias",
      "grupo": "A00-A09",
      "grupoDesc": "Doenças infecciosas intestinais",
      "categoria": "A00",
      "categoriaDesc": "Cólera",
      "tipo": "categoria"
    },
    {
      "versao": 11,
      "codigo": "1A00",
      "descricao": "Cólera",
      "bloco": "BlockL2-1A0",
      "blocoDesc": "Infecções intestinais bacterianas",
      "capitulo": "01",
      "capituloDesc": "Algumas doenças infecciosas ou parasitárias",
      "tipo": "categoria"
    }
  ]
}

Cada item de resultados traz o campo versao (10 ou 11) seguido dos mesmos campos do endpoint de detalhe correspondente. Retorna 400 parametro_invalido se q tiver menos de 2 caracteres.

GET /v1/inss/{codigoCid10} Pro+

Correlação de um código CID-10 com regras do INSS: carência para benefício, isenção de IRPF sobre proventos e enquadramento no Nexo Técnico Epidemiológico Previdenciário (NTEP). Esse é o diferencial pago da API cid — não existe em nenhuma API pública gratuita.

Parâmetros (path)

• codigoCid10 — código CID-10, com ou sem ponto (ex.: A15)

Exemplo curl

curl -H "X-API-Key: SUA_KEY" \
  "https://southamerica-east1-no-api-br.cloudfunctions.net/apiCid/v1/inss/A15"

Exemplo de resposta

{
  "codigo": "A15",
  "carencia": { "fonte": "Port. MTPS/MS 2.998/2001" },
  "irpf": { "fonte": "Lei 7.713/1988 art.6 XIV" },
  "ntep": null,
  "referenciaVersao": "2026-05-04"
}

Cada uma das chaves carencia, irpf e ntep é null quando não há correlação daquele tipo para o código, ou um objeto com a fonte normativa. Quando o código consta na lista B do NTEP, ntep também traz os CNAEs associados, por exemplo (código F32):

"ntep": {
  "fonte": "Dec.3048/99 anexo II lista B",
  "cnaes": [
    { "codigo": "1011-2", "descricao": "Frigorificos - abate de bovinos" },
    { "codigo": "8220-2", "descricao": "Telemarketing/call center" }
  ]
}

Retorna 400 parametro_invalido se o código não seguir o padrão CID-10 e 404 sem_mapeamento_inss quando o código é válido mas não tem nenhuma correlação INSS cadastrada.