Ogmma Revenue

Beneficiário

GET/v1/beneficiarios/{carteira}/glosas

O 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

CampoTipoO que é
limiteinteiro
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.
deslocamentointeiro
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

datalista de GlosaDoBeneficiarioO recurso. Os campos estão na tabela abaixo.
paginacaoPaginacaoOnde esta página está no total. Vem fora de data.

Campos de GlosaDoBeneficiario

CampoTipoO que é
glosaIdtextoA glosa a que este registro se refere, pelo identificador do Miydas.
niveltextoEm 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.
motivoobjetoPor que cortaram, na palavra da operadora e no termo oficial.
codigotextoO código do motivo, como a operadora o emitiu.
significadotextoO termo oficial da Tabela 38 da ANS, quando o código existe nela.
codigoOperadoratextoO código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ.
categoriatextoO agrupamento que a operadora deu ao motivo, quando ela agrupa.
descricaotextoO texto livre que a operadora escreveu sobre esta glosa.
valortextoDecimal em string. null = a fonte não informou; "0.00" = informou zero. Os dois são diferentes.
numeroGuiaPrestadortextoO número que VOCÊ deu à guia. O TISS não deixa repetir dentro do prestador, e é por ele que você reencontra a guia aqui.
numeroGuiaOperadoratextoO número que a OPERADORA deu à guia. Só existe depois que ela respondeu, e é o número que vale numa discussão com ela.
procedimentoobjetoO procedimento a que a linha se refere.
codigotextoCódigo do procedimento na tabela declarada.
descricaotextoDescrição do procedimento, como a fonte a informou.
registradaEmtextoQuando 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_glosas

A 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ódigoHTTPQuandoO que fazer
RECURSO_NAO_ENCONTRADO404O 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.