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=open~closed

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

Example: search=engineer

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

Options: Technology & Development, Product Management, Design & Creative, Marketing & Communication, Sales & Business Development, Administrative & Human Resource, Finance & Legal, Customer Support, Other

Example: categories=Technology & Development~Design & Multimedia

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.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

[ { "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:22Z" } }, "permission": "owner", "role": "hiring_manager", "invite_status": "pending", "invite_code": "string", "invite_email": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "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:22Z" }, "industry": { "id": "string", "linkedin_id": "string", "label": "string" }, "name": "string", "website": "string", "size": "1-50", "recruspace_interview_api_key": "string", "language": "en", "slug": "string" }, "title": "string", "intro_text": "string", "requirement_text": "string", "closing_text": "string", "description": "stringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstringstri", "language": "English", "locations": [ "string" ], "workplace": "remote", "employment_type": "full_time", "seniority": "intern", "category": "string", "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", "status": "draft", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ]

Request

Responses