Parcela SIGEF por UUID

Consulta uma parcela certificada no SIGEF pelo UUID, sem CPF/CNPJ do detentor, com a geometria completa.

GET /api/consultar-sigef-parcela

Consulta uma parcela certificada no SIGEF (INCRA) pelo seu UUID, sem informar CPF ou CNPJ do detentor. Use quando você já tem o identificador da parcela (por exemplo, escolhida num mapa) e precisa da geometria certificada completa: polígono em WKT, todos os vértices com ordem, anel, tipo, precisão e altitude, e todos os limites com o confrontante de cada lado.

Esta consulta não retorna dados pessoais do detentor. Para listar as parcelas de um CPF ou CNPJ, use Parcelas SIGEF.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes. A chave deve ficar no seu backend.

Parâmetros de consulta

Name	Type	Required	Description
`uuid`	string	Sim	UUID da parcela no SIGEF (formato `8-4-4-4-12`, hexadecimal). Maiúsculas são aceitas.
`force_fresh`	boolean	Não	`true` ignora o cache e lê a parcela de novo na fonte. Padrão `false`.

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/consultar-sigef-parcela?uuid=533f4e5c-d948-4588-a396-797b6577afb9" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-sigef-parcela?uuid=533f4e5c-d948-4588-a396-797b6577afb9",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
if (data.source_status.status === "success") {
  const p = data.result;
  console.log(`${p.denominacao}: ${p.vertices.length} vertices, lido em ${data.consultado_em}`);
  if (!data.completo) console.warn("Resposta parcial:", data.avisos);
}

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-sigef-parcela",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"uuid": "533f4e5c-d948-4588-a396-797b6577afb9"},
)
data = response.json()
if data["source_status"]["status"] == "success":
    p = data["result"]
    print(p["denominacao"], len(p["vertices"]), "vertices, lido em", data["consultado_em"])
    if not data["completo"]:
        print("Resposta parcial:", data["avisos"])

Resposta

Campos de nível superior

Campo	Tipo	Descrição
`request_id`	string	Identificador único da requisição.
`parcel_id`	string	UUID consultado (minúsculo).
`cached`	boolean	Se a resposta veio do cache (TTL 24h).
`consultado_em`	string	Momento (UTC, ISO 8601) em que os dados foram lidos na fonte. Em resposta de cache, é o momento da leitura original.
`completo`	boolean	`false` quando alguma parte da geometria não veio. Veja `avisos`.
`avisos`	array	Partes que faltaram: `POLIGONO_INDISPONIVEL`, `VERTICES_DETALHADOS_INDISPONIVEIS`, `LIMITES_DETALHADOS_INDISPONIVEIS`.
`source_status`	object	Status da consulta (`status`, `error_code`, `error_message`).
`result`	object \| null	A parcela (null em caso de erro).

Campos de `result`

result tem os mesmos campos de uma parcela de Parcelas SIGEF: identificação, situação, registro (matricula, cns, cartorio), codigo_sncr, area_ha, municipio, uf, codigo_ibge, requerimentos, responsável técnico, geometria_wkt, centroide, bounding box e perímetro. detentor vem vazio nesta consulta.

Nesta consulta, cada vértice e cada limite traz também:

Vértices (vertices[]), na ordem original da parcela

Campo	Tipo	Descrição
`indice`	integer	Posição original do vértice.
`lado`	string	`EXTERNO` (perímetro) ou `INTERNO` (anel interno).
`tipo`	string	Tipo do vértice: `M` (marco), `P` (ponto) ou `V` (virtual).
`sigma_x_m` / `sigma_y_m` / `sigma_z_m`	number	Precisão posicional em metros (longitude, latitude e altitude).
`longitude_decimal` / `latitude_decimal`	number	Coordenadas em graus decimais (SIRGAS 2000).
`longitude` / `latitude`	string	Coordenadas em graus, minutos e segundos.
`altitude_m`	number	Altitude em metros.
`metodo`	string	Método de posicionamento (ex: `PG6`).

Limites (confrontantes[]), na ordem original da parcela

Campo	Tipo	Descrição
`indice`	integer	Posição original do limite.
`do_vertice` / `ao_vertice`	string	Códigos dos vértices de início e fim.
`lado`	string	`EXTERNO` ou `INTERNO`.
`tipo_limite`	string	Tipo do limite (ex: `LA1`, `LA3`).
`azimute` / `azimute_decimal`	string / number	Azimute em graus e minutos e em graus decimais.
`comprimento_m`	number	Comprimento em metros.
`geometria_wkt`	string	Segmento em WKT (`LINESTRING`, SIRGAS 2000).
`descricao`	string	Texto do confrontante como registrado (matrícula vizinha, estrada, rio).
`cns` / `matricula` / `ocupante`	string	Quando houver, dados do registro do vizinho.

Os confrontantes são os descritos em cada limite da parcela. Se você já tem o UUID de uma parcela vizinha (por exemplo, pelo mapa), consulte-a com outra chamada a este endpoint.

Exemplo de resposta

{
  "request_id": "6f1c2a9e-4b7d-4f0a-9c3e-2d8b5a1e7f40",
  "parcel_id": "533f4e5c-d948-4588-a396-797b6577afb9",
  "cached": false,
  "consultado_em": "2026-10-18T23:52:26Z",
  "completo": true,
  "avisos": [],
  "source_status": { "status": "success", "error_code": "", "error_message": "" },
  "result": {
    "parcel_id": "533f4e5c-d948-4588-a396-797b6577afb9",
    "denominacao": "SITIO ESPERANÇA - Matrícula 12776",
    "area_ha": 5.659,
    "municipio": "Alfredo Wagner",
    "uf": "SC",
    "codigo_ibge": "4200705",
    "detentor": "",
    "matricula": "12776",
    "cns": "10.534-6",
    "status": "Certificada - Sem Confirmação de Registro em Cartório",
    "registro_situacao": "Não confirmado",
    "natureza": "Particular",
    "codigo_sncr": "9502111464632",
    "data_entrada": "11/09/2025",
    "data_entrada_iso": "2025-09-11",
    "requerimentos": [],
    "geometria_wkt": "POLYGON ((-49.3959472199999965 -27.6373430599999992, ...))",
    "vertices": [
      {
        "indice": 1,
        "codigo": "GV9-M-5068",
        "tipo": "M",
        "lado": "EXTERNO",
        "longitude": "-49°23'45,410\"",
        "latitude": "-27°38'14,435\"",
        "longitude_decimal": -49.39594722,
        "latitude_decimal": -27.63734306,
        "altitude_m": 846.38,
        "sigma_x_m": 0.004,
        "sigma_y_m": 0.004,
        "sigma_z_m": 0.006,
        "metodo": "PG6"
      }
    ],
    "confrontantes": [
      {
        "indice": 1,
        "do_vertice": "GV9-M-5068",
        "ao_vertice": "GV9-P-12146",
        "tipo_limite": "LA1",
        "lado": "EXTERNO",
        "azimute": "114°33'",
        "azimute_decimal": 114.556081667,
        "comprimento_m": 75.78,
        "geometria_wkt": "LINESTRING (-49.3959472199999965 -27.6373430599999992, -49.3952488899999977 -27.6376272199999988)",
        "descricao": "CNS: 10.534-6 - Mat.:220 - ...",
        "cns": "10.534-6",
        "matricula": "220",
        "ocupante": ""
      }
    ],
    "centroid_lat": -27.639035,
    "centroid_lng": -49.393444,
    "perimetro_m": 1146.47
  }
}

No exemplo, geometria_wkt, vertices e confrontantes foram encurtados (a parcela tem 29 vértices e 29 limites).

Atualização, retificação e cancelamento

A parcela pode mudar mantendo o mesmo UUID. Para acompanhar:

status traz a situação atual da parcela; requerimentos traz o histórico (tipo, status e data), incluindo retificações e cancelamentos.
consultado_em diz quando o dado foi lido. Para uma leitura nova, envie force_fresh=true.
Para detectar mudança de geometria, compare geometria_wkt (ou um hash dele) entre leituras.

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	`uuid` não foi informado.
`PARAMETRO_INVALIDO`	400	`uuid` fora do formato `8-4-4-4-12`.
`SIGEF_PARCELA_NAO_ENCONTRADA`	200	Não existe parcela com esse UUID no SIGEF.
`SIGEF_UNAVAILABLE`	200	O SIGEF não respondeu a tempo ou está indisponível. Tente novamente em alguns minutos.
`SIGEF_MAINTENANCE`	200	O SIGEF está em manutenção programada pelo INCRA. Tente novamente mais tarde.
`SIGEF_DISABLED`	200	Consulta SIGEF temporariamente desativada.
`ERRO_INTERNO`	500	Erro interno no servidor.

Nos erros com HTTP 200, o código vem em source_status.error_code e result vem null. Consultas com erro não são cobradas. Uma consulta com sucesso conta como 1 consulta, inclusive quando parcial (completo: false).

Planos e preços

Esta pagina foi util?

Parcela SIGEF por UUID

On this page