---
title: "Get a candidate source by identifier."
method: GET
path: "/configuration/sources/{sourceIdentifier}"
tags: ["configuration"]
---

# Get a candidate source by identifier.

`GET /configuration/sources/{sourceIdentifier}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/sources/{sourceIdentifier}`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `configuration_read`

Get a single candidate source for a given identifier (included deleted source).

## Response `200`

Source

- SourceDefinition
  - `label` string, required
  - `subType` Identifiable, required
    - `id` string, required
  - `type` Identifiable, required
    - `id` string, required

## Other responses

- `400`: Invalid source identifier. With codes * *INVALID_IDENTIFIER* - when identifier has invalid format.
- `404`: Source with given identifier not found. With codes * *SOURCE_NOT_FOUND* - when source is not found.

---

[API](https://skmtc.dev/smartrecruiters/apis/configuration-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/configuration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/configuration-api/revisions/65491281a1a6?raw)