> 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 > 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. # Get interview notes GET https://api.letsdeel.com/rest/ats/interviews/{interview_id}/notes Retrieves the AI-generated notes (summary, key points, and outline) that Interview Assistant produces for an interview, so you can export them into your own systems and workflows. Requires Interview Assistant to be enabled for your organization; if the candidate did not consent to recording and transcription, the interview has no notes and the result is empty. **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-27. Reference: https://developer.deel.com/api/reference/endpoints/ats/get-interview-notes-v-2026-10-27 ## 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 - `interview_id` (string, required) — Unique identifier of the interview to retrieve the notes for. ### Query parameters - `cursor` (string, optional) — Pagination cursor returned by a previous response. - `limit` (integer, optional) — Maximum number of notes to return per page. ### Headers - `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`. - Allowed values: `true` ## Response ### 200 Paginated list of interview notes, oldest first. - `data` (list of AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaDataItems, required) — Page of interview notes, oldest first. - `has_more` (boolean, required) — Whether more pages are available beyond the current page. - `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 notes for this interview, across all pages. ## Errors ### 400 Bad Request Error Operation failed. - `errors` (list of AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaErrorsItems, 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 AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 404 Not Found Error The interview does not exist, belongs to another organization, or is not visible to the caller. - `errors` (list of AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 500 Internal Server Error Operation failed. - `errors` (list of AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ## Types ### AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaDataItems - `id` (string, required) — Unique identifier of the interview note. - `title` (string, required) — Short AI-generated title of the note. Derived from the interview conversation. - `type_slug` (enum, required) — Kind of note: SUMMARY (overall summary), KEY_POINT (a highlight) or OUTLINE (an agenda item of the conversation). - Allowed values: `SUMMARY`, `KEY_POINT`, `OUTLINE` - `created_at` (string, required) — ISO 8601 datetime when the note was generated. - `content_text` (string, required) — AI-generated note text summarising part of the interview. Condenses what the candidate said and may contain personal data they volunteered. - `transcription_content_id` (string, required, nullable) — Identifier of the transcript segment the note was generated from, matching a segment id of the interview transcript; null when the note is not linked to a single segment. ### AtsInterviewsInterviewIdNotesGetResponsesContentApplicationJsonSchemaErrorsItems - `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": [ { "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "title": "Distributed systems experience", "type_slug": "KEY_POINT", "created_at": "2026-06-01T11:05:00Z", "content_text": "The candidate described five years of experience building event-driven services.", "transcription_content_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" } ], "has_more": false, "next_cursor": "eyJpZCI6IjEyMzQifQ==", "total_count": 12 } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes" querystring = {"cursor":"eyJpZCI6IjEyMzQifQ==","limit":"50"} headers = { "X-Beta": "true", "Authorization": "Bearer " } response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50'; const options = {method: 'GET', headers: {'X-Beta': 'true', Authorization: 'Bearer '}}; 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/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-Beta", "true") req.Header.Add("Authorization", "Bearer ") 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/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50") 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 ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50") .header("X-Beta", "true") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50', [ 'headers' => [ 'Authorization' => 'Bearer ', 'X-Beta' => 'true', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50"); var request = new RestRequest(Method.GET); request.AddHeader("X-Beta", "true"); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Beta": "true", "Authorization": "Bearer " ] let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/ats/interviews/f47ac10b-58cc-4372-a567-0e02b2c3d479/notes?cursor=eyJpZCI6IjEyMzQifQ%3D%3D&limit=50")! 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() ```