Paginação e rotina de atualização na API de Exportação dos Dados Assistenciais – IAG Saúde

A API de Exportação dos Dados Assistenciais retorna as internações em páginas, para que consultas com muitos registros sejam entregues em partes. Com a paginação e uma rotina diária de consultas, o sistema da sua instituição consegue manter uma base de dados própria sempre atualizada com as informações da Plataforma DRG Brasil.

Este artigo explica como a paginação funciona e qual rotina é recomendada para a carga inicial e para as atualizações seguintes. A configuração dessa rotina é responsabilidade da equipe de TI da instituição.

Como funciona a paginação

Cada página retorna no máximo 100 internações.
A página desejada é informada no parâmetro page, em formato numérico, no corpo da requisição, junto com os demais filtros.
Quando o filtro encontra mais de 100 internações, o sistema deve repetir a mesma consulta alterando apenas o valor de page, até receber todos os registros.
O retorno traz a lista de internações no campo itens e o campo total.

Exemplo: consulta das internações alteradas em 18/10/2026, solicitando uma das páginas seguintes do resultado. Os filtros permanecem iguais em todas as páginas; muda apenas o valor de page:

{
  "dataUltimaAlteracao": "2026-10-18",
  "page": 2
}

Observação: a numeração das páginas, incluindo o valor da página inicial, está descrita no manual técnico da API, disponível em Manuais DRG Brasil ou mediante solicitação ao Suporte.

Rotina recomendada para manter sua base atualizada

Carga inicial: busque o histórico desejado usando um dos períodos disponíveis, como o período de alta, dividindo a busca em consultas de até 31 dias.
Todas as páginas: em cada consulta, percorra todas as páginas do resultado antes de passar para a próxima.
Chave da internação: grave cada internação usando o campo id, que é a chave única da internação. Se o id já existir na sua base, atualize o registro; se não existir, inclua.
Atualização diária: após a carga inicial, consulte diariamente as internações pela data da última alteração, informando a data do dia anterior (D-1).
Exclusões: consulte também as internações excluídas no dia anterior e remova esses registros da sua base.

Atenção: o token de acesso expira a cada 4 horas. Em cargas iniciais longas, com muitas consultas e páginas, gere um novo token sempre que necessário para não interromper a rotina.

Artigos Populares

Perguntas Frequentes

Quantas internações vêm em cada página?

No máximo 100 internações por página. Para receber os demais registros, repita a consulta alterando o parâmetro page.

Qual campo devo usar como chave da internação na minha base?

O campo id, que é a chave única de cada internação no DRG Brasil.

Com que frequência devo consultar a API para manter a base atualizada?

Após a carga inicial, a recomendação é fazer uma consulta diária pela data da última alteração, informando o dia anterior (D-1).

Como sei quais internações foram excluídas da Plataforma?

Use a consulta de internações excluídas, informando a data da exclusão. Os registros retornados devem ser removidos da sua base.

Este documento e seus anexos são restritos ao(s) destinatário(s) e poderão ser divulgados apenas para pessoas que necessitem dessas informações para a realização de suas atividades.
Se você o recebeu por engano, entre em contato com o remetente imediatamente e apague-o de seus arquivos.
Qualquer uso não autorizado, replicação ou disseminação deste documento, ou parte dele, é proibido. Antes de imprimir, pense no meio ambiente.

Relativo a