Ogmma Revenue

Autorização

GET/v1/autorizacoes/{id}

Uma autorização, com o histórico

Escopo:
autorizacao:ler
Resposta:
200

Pedido

Caminho

{id}*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.

Exemplo de chamada

curl -X GET https://api.miydas.com.br/v1/autorizacoes/cmf3k2x9a0001aut \
  -H "Authorization: Bearer $MIYDAS_CHAVE"

Resposta 200

dataAutorizacaoO recurso. Os campos estão na tabela abaixo.

Campos de Autorizacao

CampoTipoO que é
idtextoIdentificador 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.
operadoraobjetoA operadora do documento, identificada pelo registro ANS.
registroANStextoRegistro 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.
nometextoRazão social da operadora como a ANS a publica. Informativo — a chave é o registro.
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.
processamentoProcessamentoO andamento do pedido COM A OPERADORA. Enquanto ele não concluir, a situação abaixo é nula — o recurso existe, a resposta ainda não.
situacaoobjetoNula até a operadora responder. codigoOperadora é o que ela mandou.
codigotexto
um de: A_ENVIAR, ENVIANDO, EM_ANALISE, AUTORIZADA, PARCIALMENTE_AUTORIZADA, NEGADA, AGUARDANDO_JUSTIFICATIVA, AGUARDANDO_DOCUMENTACAO, CANCELADA, NAO_EXIGE_AUTORIZACAO, INDETERMINADA
O veredito traduzido. NAO_EXIGE_AUTORIZACAO não é negativa: é a operadora dizendo que o procedimento passa direto.
descricaotextoO mesmo estado de situacao.codigo, em português, para mostrar a gente. O contrato é o código; esta frase pode mudar.
codigoOperadoratextoO código do prestador NA operadora. Cada operadora tem o seu, e é ele que a operadora exige no documento — não o CNPJ.
senhatextoA senha de autorização que a operadora concedeu. É ela que autoriza a execução.
validadeSenhatextoÚltimo dia em que a senha de autorização pode ser usada. Passou disso, a guia volta para a fila.
dataAutorizacaotextoData em que a operadora autorizou, AAAA-MM-DD.
dataSolicitacaotextoO dia em que a autorização foi pedida. É por ele que de e ate recortam a listagem.
beneficiarioobjetoO 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.
carteiratextoNúmero da carteirinha do beneficiário na operadora, como está no cartão. Sem máscara nem separador.
nometextoNome do beneficiário como a operadora o devolveu — pode divergir do seu cadastro.
solicitanteobjetoQuem pediu o procedimento.
nometextoNome do profissional solicitante.
conselhotextoSigla do conselho profissional (CRM, CRO, COREN…).
numerotextoNúmero de inscrição do solicitante no conselho.
uftextoSigla da unidade federativa, duas letras (ex. SC).
cbotextoOcupação do profissional na CBO, seis dígitos.
pedidoobjetoO que foi pedido, como está gravado agora — e é isto que PATCH /v1/autorizacoes/{id} corrige enquanto a guia não foi autorizada. Vem junto porque campo corrigível sem o valor atual ao lado se lê como "não preenchido", e quem corrige reescreve por cima do que havia.
caratertexto
um de: ELETIVO, URGENCIA
Eletivo ou urgência/emergência.
indicacaoClinicatextoA justificativa clínica do pedido, como foi enviada.
observacaotextoObservação livre para o auditor da operadora.
numeroGuiaPrincipaltextoA guia principal, quando esta é continuação de outra.
coberturaEspecialtextoCobertura especial (dm_tipoCoberturaEspecial): gestante, aidético ou recém-nascido.
recemNascidobooleanoAtendimento a recém-nascido na mesma guia da mãe.
atendimentoobjetoTipo e regime de atendimento e indicação de acidente, nos domínios TISS. null quando a operadora não os pede.
tipoAtendimentotextoTipo de atendimento (dm_tipoAtendimento). Exame de laboratório costuma ser 23.
regimeAtendimentotextoRegime de atendimento (dm_regimeAtendimento): ambulatorial, hospitalar, domiciliar.
indicacaoAcidentetextoIndicação de acidente (dm_indicacaoAcidente). 9 é "não é acidente".
saudeOcupacionaltextoTipo de saúde ocupacional (dm_tipoSaudeOcupacional), quando o exame é admissional, periódico ou demissional.
portalobjetoCampos que só certos portais pedem — CID-10, tempo de doença, data do acidente. null quando nenhum foi informado.
cidtextoCID-10 da hipótese diagnóstica, quando o portal o exige.
tempoDoencatextoHá quanto tempo o quadro dura, no formato que o portal pede.
dataAcidentetextoO dia do acidente, quando houve (AAAA-MM-DD).
evidenciasobjetoO que existe de PROVA sobre o desfecho — e não as URLs. Os arquivos são privados; os bytes saem por GET /autorizacoes/{id}/evidencia/{tela|guia}, que confere a empresa. URL assinada aqui entraria no histórico de toda consulta de lista.
telabooleanoHá print do portal no momento em que ele respondeu — autorizada, negada ou erro. Capturado no envio; guias enviadas antes de 20/11/2026 não têm.
guiabooleanoHá o PDF que a própria operadora imprime, baixado no ato da autorização. Só onde o portal oferece impressão nativa.
procedimentoslista de objetosOs procedimentos do documento.
idtextoIdentifica este procedimento. É o que se manda em refazItem ao pedir de novo o que foi negado.
tabelatextoQual tabela o código usa (22 = TUSS procedimentos, 00 = tabela própria da operadora). Padrão 22.
codigotextoCódigo do procedimento na tabela declarada.
descricaotextoDescrição do procedimento, como ela vai no documento.
quantidadeSolicitadanúmeroQuantas unidades você pediu.
quantidadeAutorizadanúmeroQuantas a operadora liberou. Menor que a solicitada é autorização parcial — execute só o autorizado, ou a diferença vira glosa.
quantidadeExecutadanúmeroQuantas foram REALMENTE executadas, quando já se declarou. null é "ainda não declarado" e 0 é "conferi e não executei" — a diferença importa. Item com quantidadeAutorizada nula e esta preenchida é exame acrescentado na execução.
motivoslista de textoO que a operadora alegou sobre ESTE procedimento.
refazItemtextoO id do procedimento que este refaz, numa guia anterior. null é a primeira tentativa. É por esta cadeia que se sabe quantas vezes o mesmo exame foi pedido.
motivoslista de textoO que a operadora alegou sobre a guia inteira.
requisicaoobjetoA requisição que originou a guia. null quando ela nasceu direto. parte/partes respondem "por que três guias?" — a operadora limita exames por guia, e a requisição foi dividida.
idtextoA requisição, para abrir o papel que originou esta guia.
numerotextoO número legível da requisição, do prestador para o prestador (REQ-2026-0412).
partenúmeroQual das guias desta requisição é esta. null quando a requisição gerou uma só.
partesnúmeroEm quantas guias a requisição foi dividida pelo limite de exames da operadora.
proximaAcaoobjetoO que fazer agora com esta guia. Decidido pelo servidor: só ele sabe quantos dias de silêncio deixam de ser normais, o que cada código de negativa significa e se a senha está vencendo. Mostre; não recalcule.
codigotextoENVIAR, CONSULTAR, IMPRIMIR_GUIA, REFAZER_COM_CAPTURA… — para a interface decidir o botão.
textotextoA frase pronta, escrita para quem está no balcão.
precisaDeMimbooleanoEsta guia espera alguém AGORA. Guia em análise dentro do prazo responde false — enchê-la na fila é como se esconde a que precisa.
execucaoobjetoA execução do exame, nas operadoras que exigem registrá-la depois do atendimento. null não afirma que o exame não foi feito: afirma que não foi executado pelo Miydas — pode ter sido registrado à mão no portal da operadora.
executadabooleanoA operadora registrou o atendimento.
parcialbooleanoParte do pedido entrou na guia; o resto continua pendente.
guiaGeradatextoA guia de serviço que a operadora emitiu ao executar — número NOVO, diferente de numeroGuiaOperadora, e é ele que o faturamento cobra.
situacaoOperadoratextoO rótulo que a operadora deu à execução (ex.: "Executada").
mensagemtextoO que a operadora respondeu à execução, na frase dela — inclusive a recusa, quando houve.
emtextoQuando a execução foi registrada.
historicolista de objetosO que já se fez com esta guia, em ordem — a solicitação e cada consulta ou cancelamento depois dela.
ocorridoEmtextoQuando o fato aconteceu, em ISO 8601 com fuso.
tipotexto
um de: SOLICITACAO, CONSULTA, CANCELAMENTO
Que ação foi esta.
origemtexto
um de: SOLICITACAO, CONSULTA
SOLICITACAO: a guia nasceu aqui. CONSULTA: foi pedida fora do Miydas e importada depois.
etapatexto
um de: PREVIA, EXECUCAO
Como a guia foi pedida: PREVIA antes de executar (o caso normal) ou EXECUCAO com o exame já feito. Decide se a operadora cobra a confirmação de presença do beneficiário — por isso quem vai transmitir uma guia A_ENVIAR precisa saber antes de enviar.
testebooleanotrue: criado por chave de teste (myd_test_…), executado na homologação da operadora e visível só para chaves de teste.
proximaConsultaEmtextoQuando o acompanhamento automático volta a perguntar à operadora. null quando a guia não está em acompanhamento — porque já tem desfecho, ou porque ainda não saiu daqui. Serve para não consultar à mão o que o robô já ia consultar.
consultasAutomaticasnúmeroQuantas vezes o Miydas já reconsultou esta guia por conta própria.
criadaEmtextoQuando o registro nasceu no Miydas, em ISO 8601 com fuso.
atualizadaEmtextoQuando o registro mudou pela última vez no Miydas, em ISO 8601 com fuso.

Exemplo de retorno

{
  "data": {
    "id": "cmf3k2x9a0001aut",
    "operadora": {
      "registroANS": "334561",
      "nome": "Unimed Blumenau"
    },
    "numeroGuiaPrestador": "000123",
    "numeroGuiaOperadora": "18700001",
    "processamento": {
      "status": "CONCLUIDO",
      "iniciadoEm": "2026-09-27T13:02:10.000Z",
      "concluidoEm": "2026-09-27T13:02:14.000Z"
    },
    "situacao": {
      "codigo": "AUTORIZADA",
      "descricao": "Autorizada",
      "codigoOperadora": "1"
    },
    "senha": "18700001",
    "validadeSenha": "2026-10-27",
    "dataAutorizacao": "2026-09-27",
    "dataSolicitacao": "2026-09-27",
    "beneficiario": {
      "carteira": "00000000000000000",
      "nome": "PACIENTE EXEMPLO"
    },
    "solicitante": {
      "nome": "Médica Exemplo",
      "conselho": "CRM",
      "numero": "12345",
      "uf": "SC",
      "cbo": "225124"
    },
    "evidencias": {
      "tela": true,
      "guia": true
    },
    "pedido": {
      "carater": "ELETIVO",
      "indicacaoClinica": "Investigação de anemia",
      "observacao": null,
      "numeroGuiaPrincipal": null,
      "coberturaEspecial": null,
      "recemNascido": false,
      "atendimento": {
        "tipoAtendimento": "23",
        "regimeAtendimento": "01",
        "indicacaoAcidente": "9",
        "saudeOcupacional": ""
      },
      "portal": {
        "cid": "D509",
        "tempoDoenca": "",
        "dataAcidente": ""
      }
    },
    "procedimentos": [
      {
        "id": "cm3p0r0c1",
        "tabela": "22",
        "codigo": "40304361",
        "descricao": "Hemograma com contagem de plaquetas",
        "quantidadeSolicitada": 1,
        "quantidadeAutorizada": 1,
        "quantidadeExecutada": 1,
        "motivos": [],
        "refazItem": null
      }
    ],
    "motivos": [],
    "requisicao": null,
    "proximaAcao": {
      "codigo": "IMPRIMIR_GUIA",
      "texto": "Nada — imprimir e atender",
      "precisaDeMim": false
    },
    "execucao": null,
    "historico": [
      {
        "ocorridoEm": "2026-09-27T13:02:14.000Z",
        "tipo": "SOLICITACAO"
      }
    ],
    "origem": "SOLICITACAO",
    "etapa": "PREVIA",
    "teste": false,
    "proximaConsultaEm": null,
    "consultasAutomaticas": 0,
    "criadaEm": "2026-09-27T13:02:10.000Z",
    "atualizadaEm": "2026-09-27T13:02:14.000Z"
  }
}

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/autorizacoes_obter

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.