> This page is for API, version Beta.
> 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.

# Retrieve a list of ATS hires

GET /ats/hires

Lists which ATS applications were hired into which HRIS profiles. Use it to keep an external HR or payroll system in step with hiring outcomes by polling for recent changes. A hire whose application is later deleted drops out of the feed without a marker, so run a full sync from time to time.

 **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-01-01.

Reference: https://developer.deel.com/api/reference/endpoints/ats/retrieve-a-list-of-ats-hires-v-2026-10-01

## 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/

## Request

### Query parameters

- `cursor` (string, optional) — Cursor for pagination. Use the next_cursor value from the previous response to get the next page of results.
- `limit` (integer, optional, default: 30) — Maximum number of records to return per page
- `updated_after` (string, optional) — Return only records updated strictly after this timestamp (ISO 8601 format). Use it to poll for changes: set it a few minutes before the updated_at of the last row you read, because a row can commit late with an earlier updated_at. Rows then repeat, so upsert by application_id.

### Headers

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

## Response

### 200

Successfully retrieved hires.

- `data` (list of AtsHiresGetResponsesContentApplicationJsonSchemaDataItems, required) — Page of application-to-HRIS-profile records, ordered by updated_at ascending.
- `has_more` (boolean, required) — Whether more pages are available beyond the current one.
- `next_cursor` (string, required, nullable) — Cursor to fetch the next page; null when there are no more pages.
- `total_count` (integer, required) — Total number of hires matching the filters.

## Errors

### 400 Bad Request Error

Operation failed.

- `errors` (list of AtsHiresGetResponsesContentApplicationJsonSchemaErrorsItems, 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 AtsHiresGetResponsesContentApplicationJsonSchemaErrorsItems, 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 AtsHiresGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects

## Types

### AtsHiresGetResponsesContentApplicationJsonSchemaDataItems

- `offer_id` (string, required) — Identifier of the accepted offer the hire was created from
- `worker_id` (integer, required, nullable) — Worker identifier of the same HRIS profile. Null while the profile does not exist yet.
- `updated_at` (string, required) — Timestamp of the last change to the record. Records are returned oldest change first, so the last row of a drain is a safe watermark.
- `status_enum` (enum, required) — State of the move to HRIS. DRAFT: a draft quote exists but no contract yet. CREATED: the HRIS profile and contract exist. DRAFT_DELETED: the draft was discarded.
  - Allowed values: `DRAFT`, `DRAFT_DELETED`, `CREATED`
- `candidate_id` (string, required) — Identifier of the candidate the application belongs to
- `application_id` (string, required) — Identifier of the ATS application that was moved to HRIS
- `draft_quote_id` (string, required, nullable) — Identifier of the draft quote associated with this hire. Null when no draft quote exists.
- `hris_profile_id` (integer, required, nullable) — Numeric identifier of the HRIS profile the application was hired into. Null while the profile does not exist yet.
- `organization_id` (string, required) — Identifier of the organization that owns the record
- `hris_profile_public_id` (string, required, nullable) — Public (UUID) identifier of the same HRIS profile as hris_profile_id. Null while the profile does not exist yet.

### AtsHiresGetResponsesContentApplicationJsonSchemaErrorsItems

- `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

## Examples

**Response**

```json
{
  "data": [
    {
      "offer_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "worker_id": 900001,
      "updated_at": "2025-09-17T13:33:04.523Z",
      "status_enum": "CREATED",
      "candidate_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "application_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "draft_quote_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "hris_profile_id": 987654,
      "organization_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "hris_profile_public_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wOS0xN1QxMzozMzowNC41MjNaIiwibGFzdElkIjoiYWZmZjRhMzAtMWY0ZS00NTMyLTk0MDItNGJmODk2NDFkMjE4In0=",
  "total_count": 42
}
```

**SDK Code**

```python
import requests

url = "https://api.example.com/ats/hires"

querystring = {"cursor":"eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0=","limit":"30","updated_after":"2025-06-18T00:00:00.000Z"}

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

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

print(response.json())
```

```javascript
const url = 'https://api.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z';
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.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z"

	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.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z")

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.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z")
  .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.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'X-Beta' => 'true',
  ],
]);

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

```csharp
using RestSharp;

var client = new RestClient("https://api.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z");
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.example.com/ats/hires?cursor=eyJsYXN0VXBkYXRlZEF0IjoiMjAyNS0wNi0xOFQwOToxNzoyMi40NDFaIiwibGFzdElkIjoiMWVhOTlmMzYtZWEzYy00N2QyLWI3NDAtNmFkNTM2ZjU4OTI4In0%3D&limit=30&updated_after=2025-06-18T00%3A00%3A00.000Z")! 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()
```