Glosas
/v1/glosasGlosas com o significado oficial da Tabela 38 da ANS
Cada glosa devolve motivo.significado — a diferença entre "1705" e o que 1705 quer dizer. Medido em produção: 56.267 glosas, 54.138 ligadas à Tabela 38.
competencia é o mês do PROTOCOLO, não o da emissão do demonstrativo: o portal renderiza o documento no download, e o mês da emissão difere do do protocolo em 96,1% dos documentos medidos.
semCodigo=true traz só as que a operadora cortou sem dizer por quê, que é material de recurso. motivo.tipo é derivado do que está presente, e não lido da coluna tipoMotivo — ela está nula em 93 % das linhas, e confiar nela classificaria quase tudo como desconhecido.
- Escopo:
- glosa:ler
- Resposta:
- 200
Pedido
Parâmetros de query
| Campo | Tipo | O que é |
|---|---|---|
| registroANS | texto 1–20 caracteres | Registro da operadora na ANS, seis dígitos (ex. 334561). É a chave de operadora em toda a API — não usamos nome nem código interno para identificar operadora. |
| competencia | texto formato AAAA-MM | Mês AAAA-MM da data de NEGÓCIO do documento, em UTC — crédito na retenção, protocolo na glosa. NUNCA a data de emissão: o portal renderiza o documento no download, então a emissão é o dia em que nós baixamos. |
| codigo | texto 1–20 caracteres | O código do motivo da glosa, como a operadora o emitiu. Quando ela usa o oficial, é o código da Tabela 38 da ANS. |
| nivel | texto um de: PROTOCOLO, GUIA, ITEM | Em que nível a glosa pende: ITEM, GUIA ou PROTOCOLO. Medido na base: 56.709 em item, 262 em guia, nenhuma em protocolo — o recurso TISS é item a item, e é no item que a glosa quase sempre mora. |
| semCodigo | texto um de: true, false | Só as glosas sem motivo codificado: a operadora cortou e não disse por quê. É material de recurso, e sem este filtro você teria de saber que "sem código" são três campos nulos ao mesmo tempo. |
| valorMinimo | número | Traz só registros com valor igual ou acima deste, em reais. |
| limite | inteiro 1–200 · padrão 50 | Quantos registros trazer nesta página. O teto varia por rota (50 a 200) e está nas regras do campo. |
| deslocamento | inteiro padrão 0 | Quantos registros pular, para a página seguinte. Use com paginacao.total da resposta; paginacao.temMais diz se vale pedir mais. |
* obrigatório. Campo desconhecido é recusado, não ignorado: a API responde VALIDATION_ERROR em vez de descartar em silêncio.
Exemplo de chamada
curl -X GET https://api.miydas.com.br/v1/glosas \
-H "Authorization: Bearer $MIYDAS_CHAVE"Resposta 200
| data | lista de Glosa | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde esta página está no total. Vem fora de data. |
Uma glosa, no nível em que a operadora a declarou, com o significado oficial do motivo.
Campos de Glosa
| Campo | Tipo | O que é |
|---|---|---|
| id | texto | Identificador do recurso no Miydas. Opaco e estável — NÃO é o número que a operadora ou o seu sistema usam para a mesma coisa. Guarde-o como veio e não derive significado do formato. |
| nivel | texto um de: PROTOCOLO, GUIA, ITEM | Em que nível a glosa pende: ITEM, GUIA ou PROTOCOLO. Medido na base: 56.709 em item, 262 em guia, nenhuma em protocolo — o recurso TISS é item a item, e é no item que a glosa quase sempre mora. |
| motivo | objeto | O motivo como a operadora o deu. significado vem da Tabela 38 da ANS quando o código existe lá. |
| codigo | texto | O código do motivo, como a operadora o emitiu. |
| significado | texto | Termo oficial da Tabela 38. Nulo quando o código não existe na tabela. |
| tipo | texto um de: TABELA_ANS, CODIGO_OPERADORA, CATEGORIA, TEXTO_LIVRE, NENHUM | Derivado do que está presente, não do campo tipoMotivo do banco — que está nulo em 93 % das linhas. |
| tipoDeclarado | texto | O que o parser gravou em tipoMotivo. Para auditar o parser, não para decidir. |
| codigoOperadora | texto | O código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ. |
| categoria | texto | O agrupamento que a operadora deu ao motivo, quando ela agrupa. Mais grosso que o código e, em operadora que não usa a Tabela 38, às vezes a única pista. |
| notaAuditor | texto | Argumento do auditor da operadora. Insumo direto de recurso. |
| descricao | texto | O texto livre que a operadora escreveu sobre esta glosa, além do motivo codificado. |
| valor | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| operadora | objeto | A operadora do documento, identificada pelo registro ANS. |
| registroANS | texto | Registro da operadora na ANS, seis dígitos (ex. 334561). É a chave de operadora em toda a API — não usamos nome nem código interno para identificar operadora. |
| nome | texto | Razão social da operadora como a ANS a publica. Informativo — a chave é o registro. |
| competencia | texto | YYYY-MM (UTC) da data de NEGÓCIO: crédito na retenção, protocolo na glosa. Nunca da emissão. |
| protocolo | texto | O protocolo que a operadora devolveu ao receber. É o número que prova a entrega e por onde se consulta o andamento depois. |
| guia | objeto | A guia a que este registro pertence. |
| numeroGuiaPrestador | texto | O número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui. |
| numeroGuiaOperadora | texto | O número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela. |
| carteira | texto | Número da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador. |
| beneficiario | texto | O nome do beneficiário, como a operadora o devolveu. Pode divergir do seu cadastro, e em boa parte dos documentos nem vem — a carteirinha é que identifica. |
| item | objeto | O item glosado. Nulo em glosa de nível GUIA ou PROTOCOLO — e é por ele que se monta o recurso, que no TISS é item a item. |
| codigoTabela | texto | Qual tabela o código usa (22 = TUSS procedimentos, 18/19/20 = materiais, taxas e medicamentos, 00 = tabela própria da operadora). |
| codigoProcedimento | texto | Código do procedimento na tabela declarada em codigoTabela. |
| descricao | texto | A descrição do procedimento glosado, como o documento a trouxe. |
| evidencia | objeto | O documento de onde a glosa saiu, com até onde ele veio. |
| demonstrativoId | texto | O demonstrativo a que este registro pertence, pelo identificador do Miydas. |
| emitidoEm | texto | Quando NÓS recebemos o documento — o portal o renderiza no download. |
| protocoloEm | texto | A data de negócio do protocolo, de onde sai a competência. |
| fonteOrdem | inteiro | Qual arquivo do demonstrativo composto trouxe esta glosa. |
| completude | texto | FULL | ACCEPTED_ONLY | GLOSA_ONLY — o que o conjunto de arquivos permite afirmar. |
| profundidade | texto | Até onde o documento desce: PROTOCOLO, GUIA ou ITEM. Documento que para na guia não permite recurso item a item. |
| registradaEm | texto | Quando o Miydas registrou o fato, em ISO 8601 com fuso. Não é quando ele aconteceu na operadora. |
Exemplo de retorno
{
"data": [
{
"id": "cmf3k2x9a0001glo",
"nivel": "ITEM",
"motivo": {
"codigo": "1705",
"significado": "VALOR APRESENTADO A MAIOR",
"tipo": "TABELA_ANS",
"tipoDeclarado": null,
"codigoOperadora": null,
"categoria": null,
"notaAuditor": null
},
"descricao": "Item não liberado na análise",
"valor": "8.94",
"operadora": {
"registroANS": "334561",
"nome": "Unimed Blumenau"
},
"competencia": "2026-09",
"protocolo": "PROTO-18700001",
"guia": {
"numeroGuiaPrestador": "000123",
"numeroGuiaOperadora": "18700001",
"carteira": "00000000000000000",
"beneficiario": "PACIENTE EXEMPLO"
},
"item": {
"codigoTabela": "22",
"codigoProcedimento": "40301591",
"descricao": "Colesterol (LDL)"
},
"evidencia": {
"demonstrativoId": "cmf3k2x9a0002dem",
"emitidoEm": "2026-09-30",
"protocoloEm": "2026-09-12",
"fonteOrdem": 0,
"completude": "FULL",
"profundidade": "A"
},
"registradaEm": "2026-10-01T09:14:22.000Z"
}
],
"paginacao": {
"total": 1,
"limite": 20,
"deslocamento": 0,
"temMais": false
}
}Experimente sem chave
O sandbox devolve este mesmo corpo, sem autenticação e sem tocar na base de ninguém.
curl https://api.miydas.com.br/v1/sandbox/glosas_listarA chave de teste myd_test_… é outra coisa: ela opera na homologação da operadora e serve para escrever. Para ver o formato antes de ter credencial, convênio e varredura, é este sandbox.
Erros
Esta rota não tem erro próprio: só os comuns a qualquer chamada com chave — chave ausente ou inválida, escopo insuficiente, parâmetro recusado e erro interno.
Toda falha tem o mesmo formato: { "error": "CODIGO", "message": "…", "details": { … } }. error é estável e serve para lógica; message é para gente e pode mudar. Erros comuns a toda rota com chave (lista completa) não se repetem aqui.