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/ |
| Reader page | 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 |
| 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 (PrompTugal.news). This page, the card and the records we add: CC 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"
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.
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.
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).
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.
Preview of the values
Not read yet: no values to show.