> This page is for API, version 2026-01-01 (Stable) (default).
> For other versions, use one of these documentation indexes:
> - 2026-01-01 (Stable) (default): https://developer.deel.com/api/stable/llms.txt
> - Beta: https://developer.deel.com/api/beta/llms.txt
> - Deprecated: https://developer.deel.com/api/deprecated/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# List activities configured on the stages of a job

GET https://api.letsdeel.com/rest/ats/jobs/{job_id}/activities

Returns the activities (interviews, emails, evaluations, exercises, questionnaires, documents) configured on the stages of the job interview plan. Use it to find the activity ids to pass when moving an application between stages, or to spot activities that are not fully configured and block a stage move.

 **Token scopes**: `ats:read`, `worker:read`

 **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-02-19.

Reference: https://developer.deel.com/api/reference/endpoints/ats/list-job-activities-v-2026-11-19

## Authentication

- `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
- `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

## Servers

- `https://api.letsdeel.com/rest` (Production, default)
- `https://api-staging.letsdeel.com/rest` (Demo)

## Request

### Path parameters

- `job_id` (string, required) — Job whose activities to list.

### Query parameters

- `interview_plan_stage_id` (string, optional) — Only return the activities of this interview plan stage. A stage outside the job's interview plan returns an empty list.

### Headers

- `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`.
  - Allowed values: `true`

## Response

### 200

Activities configured on the job interview plan.

- `data` (list of AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItems, required) — Activities of the job's interview plan.
- `has_more` (boolean, required) — Always false; the list is not paginated.
- `next_cursor` (string, required, nullable) — Always null; the list is not paginated.
- `total_count` (integer, required) — Number of activities returned.

## Errors

### 400 Bad Request Error

Operation failed.

- `errors` (list of AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects

### 401 Unauthorized Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 403 Forbidden Error

Forbidden. ATS is not enabled for this organization or insufficient permissions.

- `errors` (list of AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects

### 404 Not Found Error

Operation failed.

- `request` (ApiErrorRequest, optional)
- `errors` (list of ApiError, optional)

### 500 Internal Server Error

Operation failed.

- `errors` (list of AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects

## Types

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItems

An activity configured on a stage of the job.

- `id` (string, required) — Job activity identifier, the value other tools take as job_activity_id.
- `type` (enum, required) — Kind of activity.
  - Allowed values: `INTERVIEW_SCHEDULING`, `EMAIL_SENDING`, `APPLICATION_EVALUATION`, `EXERCISE`, `QUESTIONNAIRE`, `DOCUMENT_SENDING`
- `email` (AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsEmail, required, nullable) — Email settings; null unless type is EMAIL_SENDING. The delay is reported only for emails sent by ATS and is otherwise null.
- `title` (string, required) — Activity title.
- `document` (AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsDocument, required, nullable) — Document email settings; null unless type is DOCUMENT_SENDING.
- `is_draft` (boolean, required) — True when the activity is not fully configured (an interview without a Cal.com event type, an evaluation without a scorecard, an exercise without a provider or exercise type); moving an application into its stage is then rejected.
- `questionnaire` (AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsQuestionnaire, required, nullable) — Questionnaire email settings; null unless type is QUESTIONNAIRE.
- `interview_scheduling` (AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsInterviewScheduling, required, nullable) — Interview settings; null unless type is INTERVIEW_SCHEDULING.
- `interview_plan_stage_id` (string, required) — Interview plan stage the activity belongs to.

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaErrorsItems

- `code` (string, required) — Machine-readable error code
- `message` (string, required) — Human-readable error message
- `field` (string, optional) — Request field related to the error, if applicable

### ApiErrorRequest

- `method` (string, optional) — The HTTP method of the failed request
- `url` (string, optional) — The relative URL of the failed request
- `status` (double, optional) — The status code of the response
- `api_req_id` (string, optional) — The request ID of the failed request
- `docs` (string, optional) — A link to the official documentation for the requested endpoint resource
- `source` (string, optional) — The source handler which produced the returned error
- `code` (double, optional) — The code of the source handler which produced the returned error

### ApiError

- `message` (string, optional) — A description of the returned error
- `path` (string, optional) — The JSON path where input validation failed

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsEmail

Email settings; null unless type is EMAIL_SENDING. The delay is reported only for emails sent by ATS and is otherwise null.

- `delay_unit` (enum, required, nullable) — Unit of delay_amount; null when delay_amount is null.
  - Allowed values: `HOURS`, `DAYS`, `WEEKS`
- `delay_amount` (double, required, nullable) — How long after the application enters the stage the email is sent; null when there is no delay or it is not reported.
- `email_template_id` (string, required, nullable) — Email template the activity sends.

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsDocument

Document email settings; null unless type is DOCUMENT_SENDING.

- `delay_unit` (enum, required, nullable) — Unit of delay_amount; null when delay_amount is null.
  - Allowed values: `HOURS`, `DAYS`, `WEEKS`
- `delay_amount` (integer, required, nullable) — How long after the application enters the stage the email is sent; null when there is no delay or it is not reported.
- `email_template_id` (string, required, nullable) — Email template the activity sends.

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsQuestionnaire

Questionnaire email settings; null unless type is QUESTIONNAIRE.

- `delay_unit` (enum, required, nullable) — Unit of delay_amount; null when delay_amount is null.
  - Allowed values: `HOURS`, `DAYS`, `WEEKS`
- `delay_amount` (integer, required, nullable) — How long after the application enters the stage the email is sent; null when there is no delay or it is not reported.
- `email_template_id` (string, required, nullable) — Email template the activity sends.

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsInterviewScheduling

Interview settings; null unless type is INTERVIEW_SCHEDULING.

- `interviewer_pool_id` (string, required, nullable) — Interviewer pool interviewers are drawn from when the assignment type is POOL.
- `default_participants` (list of AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsInterviewSchedulingDefaultParticipantsItems, required) — Participants preset on the activity. Round-robin interviewers are not included.
- `interview_length_in_minutes` (integer, required, nullable) — Interview length in minutes.
- `interviewer_assignment_type` (enum, required) — How interviewers are assigned to the interview.
  - Allowed values: `FIXED`, `POOL`, `ROUND_ROBIN`
- `is_interview_slot_request_enabled` (boolean, required) — Whether interviewers are asked to provide interview slots.
- `interview_booking_link_email_template_id` (string, required, nullable) — Email template used to send the booking link to the candidate.

### AtsJobsJobIdActivitiesGetResponsesContentApplicationJsonSchemaDataItemsInterviewSchedulingDefaultParticipantsItems

- `role_slug` (enum, required) — Role of the participant in the activity.
  - Allowed values: `REVIEWER`, `INTERVIEWER`, `ROUND_ROBIN_INTERVIEWER`
- `participant_hris_organization_user_id` (string, required) — Organization user of the participant.

## Examples

**Response**

```json
{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "type": "INTERVIEW_SCHEDULING",
      "email": {
        "delay_unit": "DAYS",
        "delay_amount": 2,
        "email_template_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "title": "Onsite interview",
      "document": {
        "delay_unit": "DAYS",
        "delay_amount": 2,
        "email_template_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "is_draft": false,
      "questionnaire": {
        "delay_unit": "DAYS",
        "delay_amount": 2,
        "email_template_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "interview_scheduling": {
        "interviewer_pool_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "default_participants": [
          {
            "role_slug": "INTERVIEWER",
            "participant_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
          }
        ],
        "interview_length_in_minutes": 45,
        "interviewer_assignment_type": "FIXED",
        "is_interview_slot_request_enabled": false,
        "interview_booking_link_email_template_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
      },
      "interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ],
  "has_more": false,
  "next_cursor": "string",
  "total_count": 4
}
```

**SDK Code**

```python
import requests

url = "https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities"

querystring = {"interview_plan_stage_id":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}

headers = {
    "X-Beta": "true",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479';
const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Beta", "true")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Beta"] = 'true'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479")
  .header("X-Beta", "true")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479");
var request = new RestRequest(Method.GET);
request.AddHeader("X-Beta", "true");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "X-Beta": "true",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/ats/jobs/f47ac10b-58cc-4372-a567-0e02b2c3d479/activities?interview_plan_stage_id=f47ac10b-58cc-4372-a567-0e02b2c3d479")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```