1. Integration via code
latest
  • latest
  • 1.0.0
  • Getting Started
    • Generate an API key
  • Recruiting
    • Widget Integration
      • Integration Guide via Widget
      • Embed the Widget Code in WordPress
      • Steps to Implement in a React.js Website
    • Integration via code
      • Integration via code
      • Jobs Listing
        GET
      • Job Details
        GET
  • Company Candidates
    • Company Candidate Sync API
      POST
    • Company Candidate Sync Screening Questions API
      POST
  1. Integration via code

Job Details

Developing
Prod Env
https://api.cooperhire.io
Prod Env
https://api.cooperhire.io
GET
https://api.cooperhire.io
/job_details/{job_unique_id}

Job Details API#

Retrieves the complete details of a specific job posting, including job information, company details, recruiter information, application settings, and screening questions.

Response includes#

Basic job information (title, description, department, status, unique ID)
Location and work details (country, city, address, coordinates, work mode)
Employment details (employment type, contract types, salary, education requirements)
Company information (name, website, branding configuration, career page settings)
Recruiter information (user details)
Multi-language job content (language_variations)
Application settings (resume requirement, duplicate application settings)
Screening questions with supported question types and options
Social handles and follower information (if available)

Notes#

Question types may include:
short_text
paragraph
boolean
checkbox
multiple_choice
dropdown
date
file
The config object contains branding and UI configuration used by the career page and job widgets.

Request

Authorization
Add parameter in header
api_key
Example:
api_key: ********************
Path Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.cooperhire.io/job_details/' \
--header 'api_key: <api-key>'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
  "job": {
    "title": "Backend Developer",
    "language_variations": [
      {
        "id": 8,
        "title": "Backend Developer",
        "description": "<p>We are looking for a skilled Backend Developer to build scalable APIs, optimize databases, and maintain high-performance backend services.</p>",
        "language_code": "en",
        "language_sequence": 1
      }
    ],
    "unique_id": "ABC12345",
    "employment_type": "Full-Time",
    "work_mode": "on_site",
    "education": "Bachelor degree required",
    "zip_code": "34553",
    "city": "London",
    "work_address": "London, UK",
    "country": "United Kingdom",
    "country_code": "gb",
    "coordinates": "52.52000659999999,13.404954",
    "is_precise": false,
    "currency": "EUR",
    "is_resume_optional": false,
    "salary_type": "monthly",
    "salary_kind": "single",
    "min_salary": "5000",
    "max_salary": null,
    "status": "published",
    "accept_duplicate_applications": true,
    "duplicate_application_days": 0,
    "deleted_at": null,
    "created_at": "2026-04-29T16:54:22.540Z",
    "updated_at": "2026-07-09T09:13:24.266Z",
    "post_url": "https://example.com/jobs/ABC12345",
    "company_department_id": 9,
    "department": "Engineering",
    "contract_types": [
      "Permanent Position",
      "Freelancer"
    ],
    "employment_types": [
      "Full-Time"
    ],
    "user": {
      "id": 1,
      "first_name": "John",
      "last_name": "Doe",
      "position": "Hiring Manager",
      "logo": {
        "url": null
      }
    },
    "follower_ids": [
      2,
      1
    ],
    "social_handles": [],
    "company": {
      "id": 1,
      "slug": "example-company",
      "name": "Example Company",
      "logo": "company-logo.png",
      "thumbnail": "company-thumbnail.png",
      "description": "Example Company is building innovative software products for businesses worldwide.",
      "website": "https://example.com",
      "config": {
        "career_page": {
          "dark": {
            "foregroundButton": "0 0 0",
            "backgroundPrimary": "19 20 29",
            "foregroundPrimary": "255 255 255",
            "primaryBrandColor": "84 100 238",
            "secondaryBrandColor": "249 249 251"
          },
          "light": {
            "foregroundButton": "255 255 255",
            "backgroundPrimary": "255 255 255",
            "foregroundPrimary": "44 44 44",
            "primaryBrandColor": "1 62 250",
            "secondaryBrandColor": "16 15 15"
          }
        },
        "jobsPerPage": "25",
        "jobs_widget": {
          "dark": {
            "foregroundButton": "0 0 0",
            "backgroundPrimary": "19 20 29",
            "foregroundPrimary": "255 255 255",
            "primaryBrandColor": "84 100 238",
            "secondaryBrandColor": "249 249 251"
          },
          "light": {
            "foregroundButton": "255 255 255",
            "backgroundPrimary": "255 255 255",
            "foregroundPrimary": "44 44 44",
            "primaryBrandColor": "1 62 250",
            "secondaryBrandColor": "16 15 15"
          }
        },
        "apply_widget": {
          "dark": {
            "foregroundButton": "0 0 0",
            "backgroundPrimary": "19 20 29",
            "foregroundPrimary": "255 255 255",
            "primaryBrandColor": "84 100 238",
            "secondaryBrandColor": "249 249 251"
          },
          "light": {
            "foregroundButton": "255 255 255",
            "backgroundPrimary": "255 255 255",
            "foregroundPrimary": "44 44 44",
            "primaryBrandColor": "14 116 253",
            "secondaryBrandColor": "16 15 15"
          }
        }
      },
      "language_preference": "de",
      "privacy_policy_url": "https://example.com/privacy-policy"
    },
    "questions": [
      {
        "id": 6,
        "question": "Previous Employer",
        "is_demographic": false,
        "is_required": false,
        "question_type": "short_text",
        "options": []
      },
      {
        "id": 7,
        "question": "Do you have more than 5 years of experience?",
        "is_demographic": false,
        "is_required": false,
        "question_type": "boolean",
        "options": [
          {
            "id": 5,
            "label": "Yes"
          },
          {
            "id": 6,
            "label": "No"
          }
        ]
      },
      {
        "id": 8,
        "question": "Do you have experience working with SQL databases?",
        "is_demographic": false,
        "is_required": false,
        "question_type": "boolean",
        "options": [
          {
            "id": 7,
            "label": "Yes"
          },
          {
            "id": 8,
            "label": "No"
          }
        ]
      },
      {
        "id": 100,
        "question": "Upload Supporting Document",
        "is_demographic": false,
        "is_required": true,
        "question_type": "file",
        "options": []
      },
      {
        "id": 133,
        "question": "Tell us about yourself",
        "is_demographic": false,
        "is_required": false,
        "question_type": "paragraph",
        "options": []
      },
      {
        "id": 134,
        "question": "Select applicable skills",
        "is_demographic": false,
        "is_required": true,
        "question_type": "checkbox",
        "options": [
          {
            "id": 34,
            "label": "Option 1"
          },
          {
            "id": 35,
            "label": "Option 2"
          },
          {
            "id": 36,
            "label": "Option 3"
          }
        ]
      },
      {
        "id": 135,
        "question": "Preferred working arrangement",
        "is_demographic": false,
        "is_required": false,
        "question_type": "multiple_choice",
        "options": [
          {
            "id": 37,
            "label": "Option 1"
          },
          {
            "id": 38,
            "label": "Option 2"
          },
          {
            "id": 39,
            "label": "Option 3"
          }
        ]
      },
      {
        "id": 136,
        "question": "Preferred notice period",
        "is_demographic": false,
        "is_required": true,
        "question_type": "dropdown",
        "options": [
          {
            "id": 40,
            "label": "Immediate"
          },
          {
            "id": 41,
            "label": "15 Days"
          },
          {
            "id": 42,
            "label": "30 Days"
          }
        ]
      },
      {
        "id": 137,
        "question": "Available start date",
        "is_demographic": false,
        "is_required": true,
        "question_type": "date",
        "options": []
      }
    ]
  }
}
Modified at 2026-07-10 10:35:09
Previous
Jobs Listing
Next
Company Candidates
Built with