List Job Posts

Fetches a list of job posts for the authenticated company, with support for filtering, searching, sorting, and pagination.

Arguments

status (string, as query parameter, optional) : Filter by job post statuses, separated by ~.

Options: draft, live, closed.

Example: status=live~closed

search (string, as query parameter, optional) : Case-insensitive search by job title.

Example: search=engineer

locations (string, as query parameter, optional) : Filter by locations, separated by ~.

Example: locations=APAC~EMEA~Ankara,Turkey

creator_ids (string, as query parameter, optional) : Filter by creator user IDs, separated by ~.

Example: creator_ids=21~45

employment_types (string, as query parameter, optional) : Filter by employment types, separated by ~.

Options: full_time, part_time, contract, intern.

Example: employment_types=full_time~contract

workplaces (string, as query parameter, optional) : Filter by workplace types, separated by ~.

Options: remote, onsite, hybrid.

Example: workplaces=remote~onsite

sort_by (string, as query parameter, optional) : Field to sort by.

Options: created_at, updated_at, title, popular.

Example: sort_by=popular

sort_type (string, as query parameter, optional) : Sort direction. Either asc or desc.

Example: sort_type=asc

page (string, as query parameter, optional) : Page number for paginated results.

Example: page=2

page_size (string, as query parameter, optional) : Number of results per page.

Example: page_size=10

Returns

200 OK : A paginated list of job posts including job details, filters applied, and candidate count.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request GET 'https://api.recruspace.com/api/v1/client/job-posts/?creator_ids&employment_types&locations&page&page_size&search&sort_by&sort_type&status&workplaces' \ --header 'Authorization: Bearer <token>'

[ { "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 ] } ]

Request

Responses