List interview and evaluation feedback across the organization

Beta

GET

/ats/feedbacks

GET

/rest/ats/feedbacks

curl -G https://api.letsdeel.com/rest/ats/feedbacks \
     -H "Authorization: Bearer <token>" \
     -d activity_type=INTERVIEW_SCHEDULING \
     -d application_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d candidate_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d cursor=eyJpZCI6IjEyMzQifQ \
     -d include=FORM_RESPONSES \
     -d interview_plan_stage_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d job_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d limit=30 \
     -d reviewer_hris_organization_user_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d scheduled_interview_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
     -d should_hide_sensitive_fields=true \
     -d sort_order=NEWEST_FIRST \
     -d status=SUBMITTED \
     --data-urlencode submitted_after=2026-01-01T00:00:00Z \
     --data-urlencode submitted_before=2026-12-31T23:59:59Z \
     --data-urlencode updated_after=2026-01-01T00:00:00Z

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "status": "SUBMITTED",
      "reviewer": {
        "participant_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "reviewer_profile": {
          "type": "CLIENT",
          "country": "US",
          "pic_url": "https://avatars.githubusercontent.com/u/12345678",
          "full_name": "Jane Smith",
          "job_title": "Engineering Manager",
          "last_name": "Smith",
          "first_name": "Jane",
          "work_email": "jane.smith@example.com",
          "hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
        }
      },
      "created_at": "2026-05-30T14:00:00Z",
      "updated_at": "2026-06-01T10:00:00Z",
      "application": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "job": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "title": "Frontend Engineer"
        },
        "candidate": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "email": "jane.smith@example.com",
          "last_name": "Smith",
          "first_name": "Jane"
        },
        "current_application_interview_plan_stage": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "interview_plan_stage": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "name": "Offer"
          }
        }
      },
      "submitted_at": "2026-06-01T10:00:00Z",
      "activity_type": "INTERVIEW_SCHEDULING",
      "feedback_form": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "title": "Technical Interview Scorecard"
      },
      "scheduled_interview": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "ends_at": "2026-06-01T10:00:00Z",
        "starts_at": "2026-06-01T09:00:00Z",
        "status_enum": "COMPLETED",
        "has_happened": true
      },
      "interview_plan_stage": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Technical Interview",
        "category_type_slug": "active"
      },
      "overall_recommendation": {
        "scale_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "scale_title": "Recommendation",
        "scale_item_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "scale_item_label": "Strong Yes",
        "scale_items_count": 4,
        "scale_item_position": 3
      },
      "application_activity_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "application_interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "form_responses": [
        {
          "answer": "Great communicator",
          "question_text": "How well did the candidate communicate?",
          "question_type": "FreeText"
        }
      ]
    }
  ],
  "has_more": false,
  "next_cursor": "eyJpZCI6IjEyMzQifQ==",
  "total_count": 42
}

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 2026-12-17.

Use this endpoint to pull organization-wide interview feedback when following up across candidates and jobs — for example, after filtering interviews or applications by stage, call this to see which reviewers still owe feedback (status=NOT_SUBMITTED) or what they recommended, without fetching each application individually. **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 2026-12-17.

Authentication

AuthorizationBearer

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 -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

job_idslist of stringsOptional

Filter feedback by job IDs.

application_idslist of stringsOptional

Filter feedback by application IDs.

candidate_idslist of stringsOptional

Filter feedback by candidate IDs.

reviewer_hris_organization_user_idslist of stringsOptional

Filter feedback by the HRIS organization user IDs of the reviewers (interviewers) who owe or submitted it.

interview_plan_stage_idslist of stringsOptional

Filter feedback by the interview plan stage of the activity it belongs to (stage ids from GET /rest/ats/jobs/{job_id}/interview-plan-stages).

scheduled_interview_idslist of stringsOptional

Filter feedback by the scheduled interview it was collected for (ids from GET /rest/ats/interviews).

statusenumOptional

SUBMITTED returns completed scorecards; NOT_SUBMITTED returns feedback still owed by a reviewer.

Allowed values:

activity_typeenumOptional

Filter by the kind of activity the feedback belongs to.

Allowed values:

submitted_afterstringOptionalformat: "date-time"

Return feedback submitted at or after this ISO 8601 datetime.

submitted_beforestringOptionalformat: "date-time"

Return feedback submitted at or before this ISO 8601 datetime.

updated_afterstringOptionalformat: "date-time"

Return feedback updated strictly after this ISO 8601 datetime (incremental sync).

includelist of enumsOptional

Optional expansions. FORM_RESPONSES embeds the submitted scorecard answers (caps limit at 50).

Allowed values:

should_hide_sensitive_fieldsbooleanOptional

When true (default), form responses marked as sensitive are omitted.

sort_orderenumOptional

Order by feedback creation time.

Allowed values:

cursorstringOptional

Pagination cursor returned by a previous response.

limitintegerOptional1-100

Maximum number of feedback records per page (1-100; 1-50 with include=FORM_RESPONSES).

Response

Paginated list of feedback records.

datalist of objects

Page of feedback records.

has_moreboolean

Whether more pages are available beyond the current page.

next_cursorstring or null

Cursor to fetch the next page; null when there are no more pages.

total_countinteger

Total number of feedback records matching the filters.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error