# Public contracts (Portal BASE)

Public contracts of the câmaras municipais of Lisboa and the Algarve's 16 municipalities, as contracting entity: object, contractors that are companies, price, dates and procedure, for the last 90 days.

Three layers: **the source** (who publishes it, the terms, when it was read), **the raw data** as the publisher served it, and **the processed data**, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.

## 1. The source

## At a glance

| Field | Value |
|---|---|
| Publisher | IMPIC, Instituto dos Mercados Públicos, do Imobiliário e da Construção (Portal BASE), through dados.gov.pt |
| Source | [https://dados.gov.pt/pt/datasets/66d72d488ca4b7cb2de28712/](https://dados.gov.pt/pt/datasets/66d72d488ca4b7cb2de28712/) |
| Reader page | [https://www.base.gov.pt/](https://www.base.gov.pt/) |
| Schedule | every 6 hours: the Pages workflow, at 00, 06, 12 and 18 UTC and on every push to dev; IMPIC's file is updated about weekly, so a run whose file has not changed does not download it again |
| Owner | data@PrompTugal.dinis |
| Collector | [sources/base-gov-pt/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/base-gov-pt/collect.mjs) |
| Since | 2026-11-18 |
| Last read | 2026-11-18 19:14 UTC |
| Last run | ok: 1 requests ok, 0 failed |
| Now | 1514 contracts |
| Licence | The data: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) (PrompTugal.news). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

IMPIC publishes these contracts as open data on dados.gov.pt with the licence "Outra (Domínio Público)" (other-pd, public domain); we name IMPIC and the Portal BASE as the source and link each contract's page. Reuse: yes: published by IMPIC as public domain on dados.gov.pt; we attribute IMPIC and keep the link to each contract on base.gov.pt.

> "license": "other-pd", "license_title": "Outra (Domínio Público)"; "description": "Contratos de 2012 a 2026 integração registada no Portal Base em www.base.gov.pt pelas entidades adjudicantes"; "frequency": "weekly"
>
> The publisher's words (pt), from [https://dados.gov.pt/api/1/datasets/66d72d488ca4b7cb2de28712/](https://dados.gov.pt/api/1/datasets/66d72d488ca4b7cb2de28712/), read on 2026-11-18.

**Open question:** Personal data: contracts name sole traders. The licence is public domain, but data protection law still applies to what we republish. We keep no natural person's name or NIF (see docs/threat-models/base-gov-pt.md); Dinis to confirm that rule.

## 2. The raw data

The raw file is IMPIC's yearly Portal BASE dataset on dados.gov.pt (about 70 MB zipped, every public contract in Portugal), read by stream and not kept here: [the dataset](https://dados.gov.pt/pt/datasets/66d72d488ca4b7cb2de28712/).

## 3. The processed data

The collector streams the yearly file, keeps the contracts whose buyer is the câmara of Lisboa or of an Algarve municipality or one of their municipal companies, shows a contractor that looks like a natural person only as "a natural person" and withholds that contract's description. The result: [latest.json](/api/v1/base-gov-pt/latest.json).

Public contracts of the last 90 days by place, value and buyer, and by procedure. The data: [/api/v1/base-gov-pt/latest.json](/api/v1/base-gov-pt/latest.json).

## More about this source

## What runs by code, by agents and by people

### Code

- the collector downloads IMPIC's yearly file from dados.gov.pt (when it changed), stream-parses it and writes latest.json and reads.json
- GitHub Actions runs it every 6 hours and deploys the site
- the build makes the API, the OpenAPI description and the pages

### Agents

- data.b.dev2@PrompTugal.dinis (Sonnet) wrote the collector and this card on 18 November 2026, reusing the approach of civic's tools/extract-base.mjs (civic.b@PrompTugal.dinis)

### People

- Dinis Cruz instructs; no person has checked the values yet (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub Actions on a public repository: no charge; one 70 MB download only when IMPIC's file has changed (about weekly) |
| build tokens | not measured |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/base-gov-pt/latest.json](https://data.promptugal.news/api/v1/base-gov-pt/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/base-gov-pt/reads.json](https://data.promptugal.news/api/v1/base-gov-pt/reads.json) |
| Card | [https://data.promptugal.news/api/v1/base-gov-pt/card.json](https://data.promptugal.news/api/v1/base-gov-pt/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/base-gov-pt/openapi.json](https://data.promptugal.news/api/v1/base-gov-pt/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/base-gov-pt/latest.json
curl -s https://data.promptugal.news/api/v1/base-gov-pt/reads.json | head -c 600
```

## Vault

Vault not yet created. The collector writes the bytes of each read to a vault copy; until the vault exists they are not kept.

## Last runs

| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-18 19:14 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:09 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:06 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:02 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 18:55 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 18:51 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 17:54 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 17:38 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:30 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:11 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:07 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:04 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:58 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:54 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:50 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:46 UTC | 2 | 0 | 2 of 2 |

Showing 16 of 16 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/base-gov-pt/reads.json).

## Preview of the values

Not read yet: no values to show.

---

Version v0.1.47 · data read 2026-11-18 19:18 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/base-gov-pt/
