---
title: "List or search all datasets"
method: GET
path: "/datasets/"
tags: ["datasets"]
---

# List or search all datasets

`GET /datasets/`

## Request

- Base URL: `https://dados.gov.pt/api/1`
- URL: `https://dados.gov.pt/api/1/datasets/`
- Auth: none declared

## Query parameters

- `q` string
- `sort` 'title' | 'created' | 'last_update' | 'reuses' | 'followers' | 'views' | '-title' | '-created' | '-last_update' | '-reuses' | '-followers' | '-views'
- `page` integer
- `page_size` integer
- `tag` string[]
- `license` string[]
- `featured` boolean
- `geozone` string[]
- `granularity` string[]
- `temporal_coverage` string
- `organization` string[]
- `badge` string[]
- `organization_badge` 'public-service' | 'certified' | 'association' | 'company' | 'local-authority'
- `owner` string
- `followed_by` string
- `format` string[]
- `format_family` string[]
- `schema` string
- `schema_version` string
- `access_type` 'open' | 'open_with_account' | 'restricted'
- `topic` string
- `frequency` string[]
- `credit` string
- `dataservice` string
- `reuse` string
- `archived` boolean
- `deleted` boolean
- `private` boolean
- `modified_since` string

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- DatasetPage
  - `data` DatasetRead[]: The page data
    - `access_audiences` AccessAudienceRead[]
      - `condition` 'yes' | 'no' | 'under_condition'
      - `role` 'local_authority_and_administration' | 'company_and_association' | 'private'
    - `access_type` 'open' | 'open_with_account' | 'restricted'
    - `access_type_reason` string
    - `access_type_reason_category` 'confidentiality_of_proceedings_of_public_authorities' | 'international_relations_public_security_or_national_defence' | 'course_of_justice_or_fair_trial' | 'confidentiality_of_commercial_or_industrial_information' | 'intellectual_property_rights' | 'confidentiality_of_personal_data' | 'protection_of_voluntary_information_suppliers' | 'protection_of_environment'
    - `acronym` string
    - `archived` string, date-time
    - `authorization_request_url` string
    - `badges` BadgeRead[]
      - `kind` string, required
    - `contact_points` ContactPointReference[]
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
    - `created_at_internal` string, date-time, required
    - `deleted` string, date-time
    - `description` string, markdown, required
    - `description_short` string
    - `ext` object
    - `extras` object
    - `featured` boolean, required
    - `frequency` 'continuous' | 'oneMinute' | 'fiveMinutes' | 'tenMinutes' | 'fifteenMinutes' | 'thirtyMinutes' | 'hourly' | 'bihourly' | 'trihourly' | 'twelveHours' | 'severalTimesADay' | 'threeTimesADay' | 'semidaily' | 'daily' | 'fiveTimesAWeek' | 'threeTimesAWeek' | 'semiweekly' | 'weekly' | 'biweekly' | 'threeTimesAMonth' | 'semimonthly' | 'monthly' | 'bimonthly' | 'quarterly' | 'threeTimesAYear' | 'semiannual' | 'annual' | 'biennial' | 'triennial' | 'quadrennial' | 'quinquennial' | 'decennial' | 'bidecennial' | 'tridecennial' | 'punctual' | 'irregular' | 'never' | 'notPlanned' | 'other' | 'unknown'
    - `frequency_date` string, date-time
    - `harvest` HarvestDatasetMetadataRead
    - `id` string, required
    - `last_modified_internal` string, date-time, required
    - `last_update` string, date-time, required
    - `license` string
    - `metrics` object
    - `organization` OrganizationReference
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `acronym` string: The organization acronym
      - `badges` BadgeRead[]: The organization badges
        - `kind` string, required
      - `logo` string: The organization logo URL
      - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version.
      - `name` string: The organization name
      - `page` string: The organization web page URL
      - `permissions` OrganizationPermissions
        - `delete` boolean
        - `edit` boolean
        - `harvest` boolean
        - `members` boolean
        - `private` boolean
      - `slug` string: The organization string used as permalink
      - `uri` string: The API URI for this organization
    - `owner` UserReference
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `avatar` string: The user avatar URL
      - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
      - `first_name` string: The user first name
      - `last_name` string: The user larst name
      - `page` string: The user web page URL
      - `slug` string: The user permalink string
      - `uri` string: The API URI for this user
    - `private` boolean
    - `quality_cached` object
    - `resources` ResourceRead[]
      - `metrics` object
    - `schema` SchemaRead
    - `slug` string, required
    - `spatial` SpatialCoverage
      - `geom` GeoJSON
        - `coordinates` object[], required: The geometry as coordinates lists
        - `type` 'Point' | 'LineString' | 'Polygon' | 'MultiPoint' | 'MultiLineString' | 'MultiPolygon', required: The GeoJSON Type
      - `granularity` object: The spatial/territorial granularity (full Granularity object if `X-Get-Datasets-Full-Objects` is set, ID of the granularity otherwise)
      - `zones` object: The covered zones identifiers (full GeoZone objects if `X-Get-Datasets-Full-Objects` is set, IDs of the zones otherwise)
    - `tags` string[]
    - `temporal_coverage` TemporalCoverage
      - `end` string, date-time: The temporal coverage end date
      - `start` string, date-time, required: The temporal coverage start date
    - `title` string, required
  - `next_page` string: The next page URL if exists
  - `page` integer, required: The current page
  - `page_size` integer, required: The page size used for pagination
  - `previous_page` string: The previous page URL if exists
  - `total` integer, required: The total paginated items

## Changes

- **2026-11-03** `77edaf8a00ea`: 1 info
  - added the new optional `query` request parameter `format_family`
- **2026-09-11** `1175d034be00`: 4 info
  - added the new optional `query` request parameter `access_type`
  - added the new optional `query` request parameter `badge`
  - added the new optional `query` request parameter `frequency`
  - added the new optional `query` request parameter `modified_since`
- **2025-11-14** `1aada30870e9`: 1 info
  - added the new optional `query` request parameter `followed_by`
- **2025-06-12** `7e14e0c246b4`: 4 info
  - added the new optional `query` request parameter `archived`
  - added the new optional `query` request parameter `deleted`
  - added the new optional `query` request parameter `private`
  - added the new optional `query` request parameter `reuse`
- **2025-03-14** `c9488618431d`: 1 info
  - added the new optional `query` request parameter `credit`

[Operation history](https://skmtc.dev/dados/apis/udata-api/changes/datasets/get.md)

---

[API](https://skmtc.dev/dados/apis/udata-api.md) - [All operations](https://skmtc.dev/dados/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dados/apis/udata-api/revisions/77edaf8a00ea?raw)