---
title: "Get job ad fields configuration"
method: GET
path: "/configuration/job-ad-fields"
tags: ["job-ad-fields"]
---

# Get job ad fields configuration

`GET /configuration/job-ad-fields`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/job-ad-fields`
- 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`

Returns job ad fields configuration for the company.

## Response `200`

Job ad fields configuration for the company

- JobAdFieldConfiguration
  - `companyId` string, required: Identifier of the company this configuration belongs to.
  - `fields` object, required: Map of stable job ad field identifiers to their configuration. The set of available fields depends on the company's enabled features.
  - `updatedAt` integer, nullable: Unix timestamp in milliseconds of the last explicit update. Null when the configuration has never been explicitly set, which represents the default state.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden to access the resource, check your authorisation and rights.

---

[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)