---
title: "List all harvest sources"
method: GET
path: "/harvest/sources/"
tags: ["harvest"]
---

# List all harvest sources

`GET /harvest/sources/`

## Request

- Base URL: `https://data.public.lu/api/1`
- URL: `https://data.public.lu/api/1/harvest/sources/`
- Auth: none declared

## Query parameters

- `page` integer
- `page_size` integer
- `owner` string
- `deleted` boolean

## Headers

- `X-Fields` string, mask

## Response `200`

Success

- HarvestSourcePage[]
  - `data` HarvestSource[]: The page data
    - `active` boolean, required: Is this source active
    - `autoarchive` boolean, required: If enabled, datasets not present on the remote source will be automatically archived
    - `backend` string, required: The source backend
    - `config` object: The configuration as key-value pairs
    - `created_at` string, date-time, required: The source creation date
    - `deleted` string, date-time: The source deletion date
    - `description` string, markdown: The source description
    - `id` string: The source unique identifier
    - `last_job` HarvestJob
      - `created` string, date-time, required: The job creation date
      - `ended` string, date-time: The job end date
      - `errors` HarvestError[]: The job initialization errors
        - `level` string, required
        - `message` string, required
      - `id` string, required: The job execution ID
      - `items` HarvestItem[]: The job collected items
        - `args` string[]: The item positional arguments
        - `created` string, date-time, required: The item creation date
        - `dataservice` DataserviceRead
          - `acronym` string
          - `archived_at` string, date-time
          - `authorization_request_url` string
          - `availability` number
          - `base_api_url` string
          - `contact_point` ContactPoint
            - `email` string, required: The contact point's email
            - `id` string: The contact point's identifier
            - `name` string, required: The contact point's name
            - `organization` OrganizationReference
              - …
            - `owner` UserReference
              - …
          - `created_at` string, date-time, required
          - `datasets` object: Visit this API link to see the list.
          - `deleted_at` string, date-time
          - `description` string: In markdown
          - `endpoint_description_url` string
          - `extras` object
          - `format` 'REST' | 'WMS' | 'WSL'
          - `harvest` HarvestMetadataRead
            - `archived_at` string, date-time
            - `backend` string
            - `created_at` string, date-time: Date of the creation as provided by the harvested catalog
            - `domain` string
            - `id` string, required
            - `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.
          - `has_token` boolean
          - `id` string, required
          - `is_restricted` boolean
          - `license` string: The ID of the license
          - `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` Badge[]: The organization badges
              - …
            - `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
            - `slug` string, required: The organization string used as permalink
            - `uri` string: The organization API URI
          - `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 profile page URL
            - `slug` string, required: The user permalink string
            - `uri` string, required: The user API URI
          - `private` boolean: Is the dataservice private to the owner or the organization
          - `rate_limiting` 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[]
          - `title` string, required
        - `dataset` DatasetReference
          - `class` string, required: The object class
          - `id` string, required: The object unique identifier
          - `acronym` string: An optional dataset acronym
          - `page` string: The web page URL for this dataset
          - `title` string: The dataset title
          - `uri` string: The API URI for this dataset
        - `ended` string, date-time: The item end date
        - `errors` HarvestError[]: The item errors
          - `level` string, required
          - `message` string, required
        - `kwargs` object: The item keyword arguments
        - `logs` HarvestError[]: The item logs
          - `level` string, required
          - `message` string, required
        - `remote_id` string, required: The item remote ID to process
        - `started` string, date-time: The item start date
        - `status` 'pending' | 'started' | 'done' | 'failed' | 'skipped' | 'archived', required: The item status
      - `source` string, required: The source owning the job
      - `started` string, date-time: The job start date
      - `status` 'pending' | 'initializing' | 'initialized' | 'processing' | 'done' | 'done-errors' | 'failed', required: The job status
    - `name` string, required: The source display name
    - `organization` OrganizationReference
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `acronym` string: The organization acronym
      - `badges` Badge[]: The organization badges
        - `kind` string, required: Kind of badge (certified, etc), specific to each model
      - `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
      - `slug` string, required: The organization string used as permalink
      - `uri` string: The organization API URI
    - `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 profile page URL
      - `slug` string, required: The user permalink string
      - `uri` string, required: The user API URI
    - `schedule` string: The source schedule (interval or cron expression)
    - `url` string, required: The source base URL
    - `validation` HarvestSourceValidation
      - `by` 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 profile page URL
        - `slug` string, required: The user permalink string
        - `uri` string, required: The user API URI
      - `comment` string: A comment about the validation. Required on rejection
      - `on` string, date-time: Date date on which validation was performed
      - `state` 'pending' | 'accepted' | 'refused', required: Is it validated or not
  - `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.dev/public/apis/udata-api.md) - [All operations](https://skmtc.dev/public/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/public/apis/udata-api/revisions/3f583ca74f7e?raw)
