---
title: "Get details of career site configuration"
method: GET
path: "/configuration/career-sites/{careerSiteId}"
tags: ["configuration"]
---

# Get details of career site configuration

`GET /configuration/career-sites/{careerSiteId}`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/career-sites/{careerSiteId}`
- 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 details of a single career site configuration by id

## Path parameters

- `careerSiteId` string, uuid, required

## Response `200`

Career site configuration details

- CareerSiteConfigurationDetails
  - `id` string, required: Unique identifier for the career site configuration.
  - `path` string, required: Path to a career site.
  - `name` string, required: Name of the career site.
  - `published` boolean, required: Whether the career site is published.
  - `jobs` object, required
    - `title` string, nullable: Title for the jobs section
    - `filters` object, required
      - `location` string[], nullable: Jobs from given cities are displayed on this career page
      - `typeOfEmploymentIds` string[], nullable: Jobs with those type of employments are displayed on this career page
      - `experienceLevelIds` string[], nullable: Jobs with those experience levels are displayed on this career page
      - `language` string[], nullable: Jobs with those languages are displayed on this career page
      - `customFields` object, nullable: Jobs with those custom fields are displayed on this career page
    - `filtersActive` boolean, required: Whether filters are active
  - `language` string, nullable: Language of the career site.
  - `useCustomSiteUrl` boolean, required: Indicator whether career site uses custom url.
  - `customSiteUrl` string, nullable: Custom URL for the career site, if applicable.

## Other responses

- `403`: Forbidden to access the resource, check your authorisation and rights.
- `404`: Career site configuration 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)
