Prefeitura de Capitão Poço

Visão Geral

API pública — não requer autenticação. Os dados retornados são exclusivamente de obras e serviços de engenharia registrados no Portal da Transparência.

URL base

http://www.capitaopoco.pa.gov.br/api

Formato de resposta

Todas as respostas são retornadas em JSON com codificação UTF-8. O cabeçalho Content-Type: application/json está sempre presente.

Obras — Listar e Filtrar

GET http://www.capitaopoco.pa.gov.br/api/obras

Retorna a lista paginada de obras e serviços de engenharia. Todos os parâmetros são opcionais e podem ser combinados.

Parâmetros de consulta

Parâmetro	Tipo	Obrigatoriedade	Descrição	Exemplo
`ano`	integer	Opcional	Filtra obras pelo ano de início.	`2026`
`mes`	string (MM)	Opcional	Filtra obras pelo mês de início (com zero à esquerda).	`03`
`nome`	string	Opcional	Busca por palavra contida no nome/objeto da obra (busca parcial).	`praça`
`situacao`	string	Opcional	Filtra pela situação: `Em andamento` ou `Concluída`.	`Em andamento`
`dt_inicio_filtro`	date (YYYY-MM-DD)	Opcional	Data inicial do período de início da obra. Usar em conjunto com `dt_fim_filtro`.	`2026-01-01`
`dt_fim_filtro`	date (YYYY-MM-DD)	Opcional	Data final do período de início da obra. Usar em conjunto com `dt_inicio_filtro`.	`2026-06-30`
`page`	integer	Opcional	Número da página (padrão: `1`).	`2`
`porPagina`	integer	Opcional	Quantidade de registros por página (padrão: `20`, máximo: `100`).	`10`

Exemplo de requisição

GET http://www.capitaopoco.pa.gov.br/api/obras?ano=2026&situacao=Em+andamento&porPagina=5

Exemplo de resposta

{ "current_page": 1, "data": [ { "cd_obra": 1, "codigo": "2024.001", "nome": "Reforma da Praça da Alvorada", "dt_inicio": "2024-08-05", "dt_fim": "2025-02-05", "prazo": 180, "valor": "487320.00", "liquidado": "340124.50", "responsavel": "ANTONIO J C DA SILVA EIRELI", "status": 1 } ], "first_page_url": "http://www.capitaopoco.pa.gov.br/api/obras?page=1", "from": 1, "last_page": 4, "last_page_url": "http://www.capitaopoco.pa.gov.br/api/obras?page=4", "next_page_url": "http://www.capitaopoco.pa.gov.br/api/obras?page=2", "path": "http://www.capitaopoco.pa.gov.br/api/obras", "per_page": 5, "prev_page_url": null, "to": 5, "total": 18 }

Obras — Detalhe por Código

GET http://www.capitaopoco.pa.gov.br/api/obras/{cd_obra}

Retorna os dados completos de uma obra específica, incluindo empenhos, liquidações e pagamentos vinculados.

Parâmetros de rota

Parâmetro	Tipo	Obrigatoriedade	Descrição
`cd_obra`	integer	Obrigatório	Identificador único da obra (campo `cd_obra` retornado no endpoint de listagem).

Exemplo de requisição

GET http://www.capitaopoco.pa.gov.br/api/obras/1

Exemplo de resposta

{ "obra": { "cd_obra": 1, "codigo": "2024.001", "nome": "Reforma da Praça da Alvorada", "dt_inicio": "2024-08-05", "dt_fim": "2025-02-05", "prazo": 180, "valor": "487320.00", "liquidado": "340124.50", "responsavel": "ANTONIO J C DA SILVA EIRELI", "tipo_administracao": "Indireta" }, "empenhos": [ { "cd_obra_empenho": 12, "empenho": "13030001", "data": "2026-03-13", "credor": "ANTONIO J C DA SILVA EIRELI", "cnpj": "38.297.946/0001-34", "modalidade": "Concorrência", "num_licitacao": "3.2023-004", "natureza_despesa": "4.4.90.51.00 - Obras e instalações", "fonte_recurso": "17490000 - Outras vinculações", "valor": "170018.15", "registro": "Realizado" } ], "liquidacoes": [ { "cd_obra_liquidacao": 5, "documento": "16030001", "empenho": "13030001", "data": "2026-03-16", "valor": "170018.15", "registro": "Realizado" } ], "pagamentos": [ { "cd_obra_pagamento": 8, "documento": "20030008", "empenho": "13030001", "data": "2026-03-20", "valor": "170.02", "registro": "Realizado" } ] }

Resposta quando não encontrado

HTTP 404 Not Found { "error": "Obra não encontrada." }

Descrição dos Campos

Objeto obra

Campo	Tipo	Descrição
`cd_obra`	integer	Identificador único da obra.
`codigo`	string	Código de referência da obra.
`nome`	string	Objeto / nome da obra.
`dt_inicio`	date	Data de início (YYYY-MM-DD).
`dt_fim`	date	Data de término previsto (YYYY-MM-DD).
`prazo`	integer	Prazo contratual em dias.
`valor`	string	Valor contratado.
`liquidado`	string	Total liquidado acumulado.
`responsavel`	string	Empresa responsável pela execução.
`tipo_administracao`	string	Tipo de administração (Direta / Indireta).

Objeto empenho

Campo	Tipo	Descrição
`empenho`	string	Número do documento de empenho.
`data`	string	Data do empenho.
`credor`	string	Nome do credor.
`cnpj`	string	CNPJ do credor.
`modalidade`	string	Modalidade de licitação.
`num_licitacao`	string	Número da licitação.
`natureza_despesa`	string	Natureza da despesa orçamentária.
`fonte_recurso`	string	Fonte de recurso.
`valor`	string	Valor empenhado.
`registro`	string	Situação do registro (ex.: Realizado).

Objetos liquidacao e pagamento

Campo	Tipo	Descrição
`documento`	string	Número do documento.
`empenho`	string	Número do empenho vinculado.
`data`	string	Data da liquidação / pagamento.
`valor`	string	Valor liquidado / pago.
`registro`	string	Situação do registro.

Documentação da API