Parâmetros de Entrada Parâmetros de Entrada (query, opcionais)

page

Número da página desejada. Inicia em 1; padrão 1. Valores negativos ou inválidos retornam 400.

size

Quantidade de ROIs por página. Padrão 10; máximo 500 por página. Valores negativos ou inválidos retornam 400.

Parâmetros de Saída Parâmetros de Saída — Paginação

pagina

Número da página retornada.

tamanhoPagina

Quantidade de itens por página.

totalItens

Total de ROIs finalizados disponíveis na API.

totalPaginas

Total de páginas, considerando o tamanho informado.

itens[]

Lista de ROIs da página (objetos descritos abaixo).

Parâmetros de Saída — Identificação do ROI (itens[])

id

Identificador único (UUID) do ROI.

numeroRoi

Número do ROI gerado pelo sistema (ex.: ROI.12082026.TO.0006).

statusRoi

Status do ROI. Nesta API o valor é sempre FINALIZADO.

retificado

true / false — indica se o registro foi retificado.

instituicaoResponsavel.nome / .sigla

Nome e sigla da instituição responsável pela abertura do ROI.

dataHoraCriacao

Data e hora de criação do registro.

dataHoraUltimaAtualizacao

Data e hora da última atualização do registro.

houveCombate

true / false — indica se houve combate ao incêndio. Quando false, não são retornadas as datas de deslocamento, primeiro ataque e controle nem os blocos combateRecursosHumanos e meiosLocomocaoCombateIncendioDiario.

Parâmetros de Saída — Local do incêndio (localIncendio)

latitude / longitude

Coordenadas do local do incêndio, em graus decimais com 6 casas.

municipio.nomeMunicipio

Município da ocorrência.

municipio.isAmazoniaLegal

true / false — o município pertence à Amazônia Legal.

municipio.unidadeFederativa (nomeUnidadeFederativa / siglaUnidadeFederativa)

Nome e sigla da UF (ex.: Tocantins / TO).

bioma.nomeBioma

Bioma da ocorrência: Amazônia, Cerrado, Mata Atlântica, Caatinga, Pampa ou Pantanal.

nivelAcionamentoRoi

Nível de acionamento: NIVEL_1, NIVEL_2 ou NIVEL_3.

nomeLocal

Nome ou descrição do local da ocorrência.

isAmazoniaLegal

true / false — o local da ocorrência está situado na Amazônia Legal.

classificacaoArea.area

Titularidade da área: Pública, Particular ou Não Identificada.

tipoLocalidade.localidade

Tipo de localidade dentro da titularidade (ex.: Terras Indígenas, Unidades de Conservação Estaduais, Propriedades Rurais). Nulo quando a titularidade é Não Identificada.

subTipoLocalidade

Subitem de localidade: preenchido por cruzamento geoespacial quando a área é Pública; informado pelo usuário quando Particular; nulo quando Não Identificada (ex.: TI Apinayé).

Parâmetros de Saída — Datas do incêndio (datasIncendio)

dataInicioIncendio

Data e hora estimada de início do incêndio.

dataDeteccaoIncendio

Data e hora da detecção do incêndio.

dataInicioDeslocamento

Data e hora de início do deslocamento das equipes. Somente quando houve combate.

dataPrimeiroAtaque

Data e hora do primeiro combate ao incêndio. Somente quando houve combate.

dataControleIncendio

Data e hora em que o incêndio foi considerado sob controle. Somente quando houve combate.

dataExtincaoIncendio

Data e hora da extinção total do incêndio.

Parâmetros de Saída — Combate e recursos humanos (combateRecursosHumanos[]; somente quando houveCombate = true)

dataReferencia

Data de referência do registro diário.

status

MANTIDO (registro mantido automaticamente a partir do dia anterior) ou ALTERADO (alterado manualmente).

metodosDeteccao[].metodo

Métodos de detecção do incêndio (ex.: Monitoramento de satélite, Informado por morador, Telefone ou mensagem).

formaExtincao

COMBATE, EXTINCAO_NATURAL ou COMBATE_COM_EXTINCAO_NATURAL.

qtdBrigadistasVoluntarios / Municipais / Comunitarios / Estaduais

Quantidade de brigadistas voluntários, municipais, comunitários e estaduais no dia.

qtdApoioComunidade

Quantidade de pessoas da comunidade em apoio.

qtdCombatentesIbama / Icmbio / BombeirosMilitares / ForcasArmadas / OutrasInstituicoes

Quantidade de combatentes por instituição de origem.

qtdCombatentesTotal

Total de combatentes envolvidos.

Parâmetros de Saída — Meios de locomoção diários (meiosLocomocaoCombateIncendioDiario[]; somente quando houveCombate = true)

data

Data do registro diário.

status

MANTIDO ou ALTERADO (mesmo domínio do registro diário de combate).

quantidadeTotal

Quantidade total de meios e veículos no dia.

meiosLocomocao[].meioLocom ocao / quantidade

Tipo de meio e quantidade utilizada no dia. Tipos: Viatura (VTR), Viatura adaptada, UTV, ATV (quadriciclo), Moto, Van, Caminhão de transporte de carga, Ônibus, ABT (Auto Bomba Tanque), ABTF (Auto Bomba Tanque Florestal), Caminhão pipa, Posto de comando móvel, Trator de pneu, Trator de esteira, Retroescavadeira, Motoniveladora, Pá carregadeira, Avião de monitoramento, Avião tanque, Helicóptero, Drone, Embarcação/lancha, Outros meios.

outroMeioLocomocao

Outro meio de locomoção, quando não contemplado no catálogo.

Parâmetros de Saída — Informações pós-incêndio (informacoesPosIncendio)

vegetacoesAtingidas[].vegetacao

Vegetação atingida (ex.: Vegetação nativa, Agricultura, Pastagem cultivada, Floresta cultivada, Outro).

estruturasAtingidas[].estrutura

Estrutura atingida (ex.: Cerca, Rede elétrica, Unidade habitacional, Nenhuma estrutura atingida, Outro).

estimativaAreaQueimada

Estimativa da área total queimada, em hectares (ha).

Parâmetros de Saída — Frentes de combate (frentesCombate[])

id

Identificador único (UUID) da frente de combate.

numeroFrente

Número sequencial da frente dentro do ROI (1, 2, 3…).

dataCombate / horaCombate

Data e hora de criação da frente de combate.

latitude / longitude

Localização da frente, em graus decimais.

instituicaoResponsavel.nome / .sigla

Instituição do usuário que registrou a frente.

isFrenteReferencia

true / false — indica se é a frente de origem/referência do ROI.

Códigos de retorno

200 OK

Consulta realizada com sucesso; dados e paginação retornados.

400 Bad Request

Parâmetros inválidos (ex.: page ou size negativos ou inadequados).

429 Too Many Requests

Limite de requisições excedido (rate limit). Aguardar e tentar novamente.

500 Internal Server Error

Erro inesperado no processamento da requisição.

Corpo de erro (ErrorResponse)

status, error, message, detailMessage, path, timestamp, campos[].