List interview and evaluation feedback across the organization

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
}

Lists interview feedback across the candidates and jobs of the organization. Use it to follow up on hiring decisions, for example to see which reviewers still owe feedback or what they recommended, without reading each application one by one; for a single application use GET /rest/ats/applications/{application_id}/feedbacks.

Token scopes: ats:read, worker:read

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

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