---
title: "Gets a specific source"
method: GET
path: "/sources/{id}"
tags: ["Source"]
---

# Gets a specific source

`GET /sources/{id}`

## Response `200`

OK

- Source — A source of line list case data.
  - `name` string — Human readable name of a source
  - `origin` object
    - `url` string — Source location, can be http, https, or s3 schemes. This must be the link to the source data download.
    - `license` string — The license under which we have the right to ingest the data. Ideally a SPDX identifier (https://spdx.org/licenses/).
    - `providerName` string — The organisation or individual who collects the data in this source.
    - `providerWebsiteUrl` string — The provider's website, or where possible their specific site for information about this outbreak (including the source data used here).
  - `format` string — Format of the source to be ingested, useful when automated ingestion
  - `dateFilter` object
    - `numDaysBeforeToday` number
    - `op` 'EQ' | 'GT' | 'LT'
  - `notificationRecipients` string[] — List of addresses to be notified of important changes to the source.
  - `excludeFromLineList` boolean — Whether cases from this source should be left out of the line list feed.
  - `hasStableIdentifiers` boolean — Whether the source includes identifiers for individual cases that remain the same over time.
  - `automation` object
    - `parser` object
      - `awsLambdaArn` string
    - `regexParsing` object
      - `fields` object[]
        - `name` string
        - `regex` string
    - `schedule` object
      - `awsRuleArn` string
      - `awsScheduleExpression` string, required
  - `uploads` Upload[]
    - `status` 'IN_PROGRESS' | 'SUCCESS' | 'ERROR'
    - `summary` object
      - `numCreated` integer
      - `numUpdated` integer
      - `error` 'INTERNAL_ERROR' | 'SOURCE_CONFIGURATION_ERROR' | 'SOURCE_CONFIGURATION_NOT_FOUND' | 'SOURCE_CONTENT_NOT_FOUND' | 'SOURCE_CONTENT_DOWNLOAD_ERROR' | 'PARSING_ERROR' | 'VALIDATION_ERROR' | 'DATA_UPLOAD_ERROR' | 'TIMEOUT'
    - `created` union
      - string
      - object
      - number

## Other responses

- `400` — Malformed request
- `403` — Forbidden
- `404` — Not found
- `422` — Unprocessable entity
- `500` — Internal server error

---

[API](https://skmtc.net/globaldothealth/apis/global-health-curator-service-api.md) · [All operations](https://skmtc.net/globaldothealth/apis/global-health-curator-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/globaldothealth/global-health-curator-service-api/revisions/5b1151265235/schema)