Beneficiário
GET
/v1/beneficiarios/{carteira}/glosasO que foi cortado desta carteirinha, e por quê
- Escopo:
- beneficiario:ler
- Resposta:
- 200
Pedido
Caminho
| {carteira}* | Número da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador. |
Parâmetros de query
| Campo | Tipo | O que é |
|---|---|---|
| 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/beneficiarios/0012345678901234/glosas \
-H "Authorization: Bearer $MIYDAS_CHAVE"Resposta 200
| data | lista de GlosaDoBeneficiario | O recurso. Os campos estão na tabela abaixo. |
| paginacao | Paginacao | Onde esta página está no total. Vem fora de data. |
Campos de GlosaDoBeneficiario
| Campo | Tipo | O que é |
|---|---|---|
| glosaId | texto | A glosa a que este registro se refere, pelo identificador do Miydas. |
| nivel | texto | 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 | Por que cortaram, na palavra da operadora e no termo oficial. |
| codigo | texto | O código do motivo, como a operadora o emitiu. |
| significado | texto | O termo oficial da Tabela 38 da ANS, quando o código existe nela. |
| 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. |
| descricao | texto | O texto livre que a operadora escreveu sobre esta glosa. |
| valor | texto | Decimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes. |
| 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. |
| procedimento | objeto | O procedimento a que a linha se refere. |
| codigo | texto | Código do procedimento na tabela declarada. |
| descricao | texto | Descrição do procedimento, como a fonte a informou. |
| registradaEm | texto | Quando o Miydas registrou o fato, em ISO 8601 com fuso. Não é quando ele aconteceu na operadora. |
Exemplo de retorno
{
"data": [
{
"glosaId": "cmf3k2x9a0001glo",
"nivel": "ITEM",
"motivo": {
"codigo": "1705",
"significado": "VALOR APRESENTADO A MAIOR",
"codigoOperadora": null,
"categoria": null
},
"descricao": "Item não liberado na análise",
"valor": "8.94",
"numeroGuiaPrestador": "000123",
"numeroGuiaOperadora": "18700001",
"procedimento": {
"codigo": "40301591",
"descricao": "Colesterol (LDL)"
},
"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/beneficiarios_glosasA 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
| Código | HTTP | Quando | O que fazer |
|---|---|---|---|
| RECURSO_NAO_ENCONTRADO | 404 | O id não existe — ou é de outra empresa, o que a API não distingue de propósito. Também a rota inexistente na v1. | Confira o id. |
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.