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

# List or search all dataservices

`GET /dataservices/`

## 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
- `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
        - `badges` BadgeRead[]
          - `kind` string, required
        - `logo` string — URL of the image
        - `logo_thumbnail` string — URL of the cropped and squared image (100x100)
        - `name` string, required
        - `page` string — Link to the udata web page for this organization
        - `permissions` OrganizationPermissions
          - `delete` boolean
          - `edit` boolean
          - `harvest` boolean
          - `members` boolean
          - `private` boolean
        - `slug` string, required
        - `uri` string — Link to the API endpoint for this organization
      - `owner` UserReference
        - `class` string, required — The object class
        - `id` string, required — The object unique identifier
        - `avatar` string — URL of the image
        - `avatar_thumbnail` string — URL of the cropped and squared image (500x500)
        - `first_name` string, required
        - `last_name` string, required
        - `page` string — Link to the udata web page for this user
        - `slug` string, required
        - `uri` string — Link to the API endpoint 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 creation as provided by the harvested catalog
      - `domain` string
      - `issued_at` string, date-time — Date of release as provided by the harvested catalog
      - `last_update` string, date-time — Date of the last harvesting
      - `modified_at` string, date-time — Date of last modification as provided by the harvested catalog
      - `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
      - `badges` BadgeRead[]
        - `kind` string, required
      - `logo` string — URL of the image
      - `logo_thumbnail` string — URL of the cropped and squared image (100x100)
      - `name` string, required
      - `page` string — Link to the udata web page for this organization
      - `permissions` OrganizationPermissions
        - `delete` boolean
        - `edit` boolean
        - `harvest` boolean
        - `members` boolean
        - `private` boolean
      - `slug` string, required
      - `uri` string — Link to the API endpoint for this organization
    - `owner` UserReference
      - `class` string, required — The object class
      - `id` string, required — The object unique identifier
      - `avatar` string — URL of the image
      - `avatar_thumbnail` string — URL of the cropped and squared image (500x500)
      - `first_name` string, required
      - `last_name` string, required
      - `page` string — Link to the udata web page for this user
      - `slug` string, required
      - `uri` string — Link to the API endpoint 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

---

[API](https://skmtc.net/data-gouv-fr/apis/udata-api.md) · [All operations](https://skmtc.net/data-gouv-fr/apis/udata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data-gouv-fr/udata-api/revisions/c302b208f9a5/schema)