Search Job

Search Job

GET

Search job records using one or more supported filters.

Request

GET

GET /v1/job/search

Headers

• Authorization: Bearer your_access_token

Query Parameters

Parameter	Type	Description
job_slug	string	Direct lookup by job slug. Takes priority over other filters when provided.
position_name	string	Job position/title.
city	string	Job city.
state	string	Job state.
country	string	Job country.
address	string	Job address.
skills	string	Job skills.
category	string	Job category.
organization_slug	string	Organization slug connected to the job.
organization_name	string	Organization name connected to the job.
primary_contact_slug	string	Primary contact slug connected to the job.
primary_contact_name	string	Primary contact full name.
primary_contact_email	string	Primary contact email address.
primary_contact_phone	string	Primary contact phone number.
job_status_id	integer	Job status ID.
job_contract_type_id	integer	Job contract type ID.
enable_job_application_form	boolean string	Filter by job application form status. Allowed values: true, false.
owner_id	integer	Owner user ID.
owner_name	string	Owner full name.
owner_email	string	Owner email address.
created_from	ISO 8601 timestamp	Return jobs created at or after this timestamp.
created_to	ISO 8601 timestamp	Return jobs created at or before this timestamp.
updated_from	ISO 8601 timestamp	Return jobs updated at or after this timestamp.
updated_to	ISO 8601 timestamp	Return jobs updated at or before this timestamp.
exact_search	boolean string	Use true for exact text matching. Default: partial matching.
sort_by	string	Allowed values: created_at, updated_at. Default: updated_at.
sort_order	string	Allowed values: asc, desc. Default: desc.
maximize	string	Comma-separated response expansions. Use all to expand all supported job fields.
page	integer	Page number. Default: 1.
limit	integer	Records per page. Default: 25. Requests above 50 are capped at 50.

Search Behavior

• Include at least one search filter to receive results.
• job_slug performs a direct lookup and takes priority over all other filters.
• Text filters use partial matching by default. Pass exact_search=true for exact text matching.
• Date range filters are inclusive. For each date range, the *_to value must be greater than or equal to the matching *_from value.
• Primary contact filters search the job's primary contact.
• Results are sorted by updated_at in descending order unless sorting parameters are provided.

Supported maximize values

owner, currency, created_by, updated_by, qualification, industry, contact, organization, all

Request Examples

Search by position

GET /v1/job/search?position_name=Software%20Engineer&city=San%20Francisco

Exact position search

GET /v1/job/search?position_name=Senior%20Software%20Engineer&exact_search=true

Search by organization and primary contact

GET /v1/job/search?organization_slug=organization_d1d6d8323f07a6615f95&primary_contact_email=anjali@example.com&maximize=organization,contact

Search by job status

GET /v1/job/search?job_status_id=1&sort_by=updated_at&sort_order=desc

Direct slug lookup

GET /v1/job/search?job_slug=job_82f997b417b262392261

Response

200

{
  "total": 1,
  "per_page": 25,
  "current_page": 1,
  "last_page": 1,
  "next_page_url": null,
  "prev_page_url": null,
  "from": 1,
  "to": 1,
  "data": [
    {
      "id": 19,
      "position_name": "Senior Software Engineer",
      "slug": "job_82f997b417b262392261",
      "city": "San Francisco",
      "state": "California",
      "country": "United States",
      "skills": "JavaScript, Node.js",
      "category": "Engineering",
      "enable_job_application_form": true,
      "organization": {
        "id": 12
      },
      "contact": {
        "id": 28
      },
      "created_at": "2026-06-21T02:49:00.000Z",
      "updated_at": "2026-07-08T17:47:00.000Z"
    }
  ]
}

400

[
  {
    "field_name": "updated_to",
    "error_message": "updated_to must be greater than or equal to updated_from"
  }
]