Applications

Reject application

Rejects an application with optional rejection reason and note context. Standard endpoint for rejection workflows and reporting consistency.

post/applications/{id}/reject

Request

  • Base URL: https://api.100hires.com/v2
  • URL: https://api.100hires.com/v2/applications/{id}/reject
  • Auth: HTTP bearer

Path parameters

idinteger required

Resource ID (numeric).

Query parameters

includestring

Comma-separated list of related resources to include. Supported: candidate — full candidate profile, cv.text — parsed plain-text CV content, job — full job payload with url_backoffice for UI deep-linking.

Request body

rejection_reason_idinteger

Rejection reason ID from GET /taxonomy/rejection-reasons.

suppress_notificationboolean

Set to true to skip sending the rejection email to the candidate.

Response

Updated application

idinteger required

Unique identifier

candidate_idinteger required

ID of the candidate

job_idinteger required

ID of the job

job_aliasstring nullable

Short alias of the job, usable in URLs (e.g. 79SZHfT)

internal_job_idstring nullable

Company's internal job identifier

company_idinteger required

ID of the company

url_backofficestring uri

Absolute backoffice URL of the application's view (candidate page in this job) in the 100Hires recruiter app. Use to render deep-links in agent UIs.

status'active' | 'hired' | 'rejected' required

Application status. Changes via hire/reject/unreject actions.

is_disqualifiedboolean required

Whether the candidate is disqualified for this application

rejected_atinteger nullable

Unix timestamp (seconds)

hired_atinteger nullable

Unix timestamp (seconds)

custom_fieldsobject nullable

Custom field values as key-value pairs

ai_scoreinteger nullable

AI-generated candidate fit score (0-100)

ai_recommendationstring nullable

AI-generated recommendation label (e.g. Strong, Good, Weak)

ai_scoring_updated_atinteger nullable

Unix timestamp (seconds) of the latest completed AI scoring result

created_atinteger required

Unix timestamp (seconds)

updated_atinteger required

Unix timestamp (seconds)

last_message_atinteger nullable

Unix timestamp (seconds) of the most recent message (email or SMS) sent to or received from the candidate in this application's company. Null if no messages exist.

days_since_last_messageinteger nullable

Number of whole days since the last message. Computed at request time. Null if no messages exist.

Example response

{
  "job_alias": "79SZHfT",
  "url_backoffice": "https://app.100hires.com/candidate/dtGeby2/79SZHfT",
  "job": {
    "alias": "79SZHfT",
    "language": "de-DE"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.