Get Job Post

GET

/api/v1/client/job-posts/{job_post_id}/

Last modified:2025-12-30 13:27:37

Retrieves the details of a specific job post belonging to the authenticated company, including metadata and candidate count.

Arguments

job_post_id (string, as path parameter) : The unique identifier (hash) of the job post to retrieve.

Example: job_post_id="d82f9a7c91b041b7b2b7612e"

Returns

200 OK : A JSON object containing the job post details including title, description, status, employment type, workplace type, locations, candidate count, and other relevant metadata.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.recruspace.com/api/v1/client/job-posts//' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "hash": "string",
    "applicant_count": 0,
    "created_by": {
        "id": 0,
        "user": {
            "id": 0,
            "email": "user@example.com",
            "first_name": "string",
            "last_name": "string",
            "profile_img": {
                "id": 0,
                "path": "string",
                "name": "string",
                "type": "string",
                "file_size": -2147483648,
                "base": "string",
                "presigned_url": "string",
                "uploaded_at": "2019-08-24T14:15:22.123Z"
            }
        },
        "permission": "admin",
        "role": "hiring_manager",
        "invite_status": "pending",
        "invite_code": "string",
        "invite_email": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "last_login": "2019-08-24T14:15:22.123Z",
        "company": "string"
    },
    "company": {
        "hash": "string",
        "logo": {
            "id": 0,
            "path": "string",
            "name": "string",
            "type": "string",
            "file_size": -2147483648,
            "base": "string",
            "presigned_url": "string",
            "uploaded_at": "2019-08-24T14:15:22.123Z"
        },
        "industry": {
            "id": "string",
            "linkedin_id": "string",
            "label": "string"
        },
        "name": "string",
        "slug": "string",
        "work_email": "user@example.com",
        "mail_verified": true,
        "website": "string",
        "linkedin_url": "string",
        "size": "1-50",
        "language": "en",
        "recruspace_interview_api_key": "string"
    },
    "department": {
        "id": 0,
        "name": "string",
        "status": "active"
    },
    "title": "string",
    "status": "draft",
    "intro_text": "string",
    "requirement_text": "string",
    "closing_text": "string",
    "description": "stringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstri",
    "language": "English",
    "locations": [
        "string"
    ],
    "workplace": "remote",
    "employment_type": "full_time",
    "seniority": "intern",
    "skills": "string",
    "salary_amount_min": 0,
    "salary_amount_max": 0,
    "salary_currency": "USD",
    "salary_type": "per_year",
    "salary_is_visible": true,
    "share_short_url": "string",
    "notified_for_expiry": true,
    "suggestion_status": "processing",
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z",
    "pipeline": 0,
    "assignees": [
        0
    ]
}

Modified at 2025-12-30 13:27:37

List Job Posts

Apply to Job Post