--- title: "List or search all dataservices" method: GET path: "/dataservices/" tags: ["dataservices"] --- # List or search all dataservices `GET /dataservices/` ## Request - Base URL: `https://dados.gov.pt/api/1` - URL: `https://dados.gov.pt/api/1/dataservices/` - Auth: none declared ## Query parameters - `page` integer - `page_size` integer - `sort` 'followers' | 'views' | 'title' | 'base_api_url' | 'created' | 'last_modified' | '-followers' | '-views' | '-title' | '-base_api_url' | '-created' | '-last_modified' - `q` string - `topic` string - `reuse` string - `modified_since` string - `owner` string - `organization` string[] - `organization_badge` string, my-custom-format - `access_type` 'open' | 'open_with_account' | 'restricted' - `tag` string - `featured` boolean - `contact_point` string - `dataset` string ## Headers - `X-Fields` string, mask ## Response `200` Success - DataservicePage - `data` DataserviceRead[]: 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_at` string, date-time - `authorization_request_url` string - `availability` number - `availability_url` string - `badges` BadgeRead[] - `kind` string, required - `base_api_url` string - `business_documentation_url` string - `contact_points` ContactPointRead[] - `contact_form` string - `email` string - `id` string, required - `name` string, required - `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 - `role` 'contact' | 'creator' | 'publisher' | 'rightsHolder' | 'custodian' | 'distributor' | 'originator' | 'principalInvestigator' | 'processor' | 'resourceProvider' | 'user', required - `created_at` string, date-time, required - `datasets` object: Visit this API link to see the list. - `deleted_at` string, date-time - `description` string, markdown - `extras` object - `featured` boolean - `format` 'REST' | 'WMS' | 'WSL' - `harvest` HarvestMetadataRead - `archived_at` string, date-time - `archived_reason` string - `backend` string - `created_at` string, date-time: Date of the creation as provided by the harvested catalog - `domain` string - `issued_at` string, date-time: Release date as provided by the harvested catalog - `last_update` string, date-time: Date of the last harvesting - `remote_id` string - `remote_url` string - `source_id` string - `source_url` string - `uri` string: RDF node ID if it's an `URIRef`. `None` if it's not present or if it's a random auto-generated ID inside the graph. - `id` string, required - `license` string: The ID of the license - `machine_documentation_url` string: Swagger link, OpenAPI format, WMS XML… - `metadata_modified_at` string, date-time, required - `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 - `permissions` DataservicePermissions - `delete` boolean - `edit` boolean - `private` boolean: Is the dataservice private to the owner or the organization - `rate_limiting` string - `rate_limiting_url` string - `self_api_url` string: Link to the API endpoint for this dataservice - `self_web_url` string: Link to the udata web page for this dataservice - `slug` string, required - `tags` string[] - `technical_documentation_url` string: HTML version of a Swagger… - `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-09-11** `1175d034be00`: 4 info - added the new optional `query` request parameter `featured` - added the new optional `query` request parameter `modified_since` - added the new optional `query` request parameter `reuse` - added the new optional `query` request parameter `topic` - **2025-06-12** `7e14e0c246b4`: 1 warning, 1 info - deleted the `query` request parameter `is_restricted` - added the new optional `query` request parameter `access_type` - **2025-03-14** `c9488618431d`: 1 info - added the new optional `query` request parameter `contact_point` - **2025-02-18** `8a6c4a5665e6`: 1 info - endpoint added [Operation history](https://skmtc.dev/dados/apis/udata-api/changes/dataservices/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)