GET /vendor/vacancies

Fetches the paginated list of active vacancies belonging to the authenticated vendor.

GET https://api.easyfind.jobs/vendor/vacancies

Headers

Header	Value	Required	Description
`Authorization`	`Bearer your_api_key_here`	Yes	Your API key
`Accept`	`application/json`	Yes	Response format
`Accept-Language`	`az` or `en`	No	Response language for translated fields

Query Parameters

Parameter	Type	Description
`type`	integer	Filter by vacancy type: `1` Full Time, `2` Part Time, `3` Remote, `4` Internship
`experience_min`	integer	Minimum years of experience required
`experience_max`	integer	Maximum years of experience required
`per_page`	integer	Results per page (min: `1`, max: `100`)
`page`	integer	Page number to retrieve (default: `1`)
`lang`	string	`az` or `en` — overrides `Accept-Language` header

Example Request

curl "https://api.easyfind.jobs/vendor/vacancies?type=1&experience_min=2&experience_max=5&per_page=15" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Accept: application/json" \
  -H "Accept-Language: az"

Response

{
  "status": "success",
  "company": "Pasha Bank",
  "data": [
    {
      "id": 15,
      "title": "Senior Laravel Developer",
      "url": "https://api.easyfind.jobs/vakansiyalar/senior-laravel-developer",
      "description": "Yeni layihələrin sıfırdan qurulması və mövcud sistemlərin optimallaşdırılması.",
      "requirements": "Ən az 4 il Laravel təcrübəsi, SQL biliyi.",
      "responsibilities": "Kod bazasının təmiz saxlanılması, API dizaynı.",
      "category": "İnformasiya Texnologiyaları",
      "city": "Bakı",
      "type": "Tam iş günü",
      "salary_min": 2500,
      "salary_max": 3500,
      "salary": null,
      "salary_type": "Aralıq (min-max)",
      "deadline": "2026-07-01",
      "created_at": "2026-06-01 11:30:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_page": 3,
    "per_page": 10,
    "total": 25,
    "next_page_url": "https://api.easyfind.jobs/vendor/vacancies?page=2",
    "prev_page_url": null
  }
}

Response Fields

Field	Type	Description
`status`	string	`success`
`company`	string	Authenticated vendor company name
`data`	array	List of vacancy objects
`data[].id`	integer	Vacancy ID
`data[].title`	string	Vacancy title
`data[].url`	string	Public vacancy URL
`data[].description`	string	Job description
`data[].requirements`	string	Requirements
`data[].responsibilities`	string	Responsibilities
`data[].category`	string	Job category (localized)
`data[].city`	string	City (localized)
`data[].type`	string	Employment type (localized)
`data[].salary_min`	integer\|null	Minimum salary
`data[].salary_max`	integer\|null	Maximum salary
`data[].salary`	integer\|null	Fixed salary
`data[].salary_type`	string	Salary type (localized)
`data[].deadline`	string	Application deadline (`YYYY-MM-DD`)
`data[].created_at`	string	Creation datetime
`pagination.current_page`	integer	Current page number
`pagination.last_page`	integer	Total pages
`pagination.per_page`	integer	Results per page
`pagination.total`	integer	Total vacancy count
`pagination.next_page_url`	string\|null	Next page URL
`pagination.prev_page_url`	string\|null	Previous page URL

Pagination

Results are paginated. Use the page query parameter to navigate between pages.

# Page 2
curl "https://api.easyfind.jobs/vendor/vacancies?page=2&per_page=10" \
  -H "Authorization: Bearer your_api_key_here"

Or use next_page_url / prev_page_url directly from the response:

let url = 'https://api.easyfind.jobs/vendor/vacancies?per_page=10';
 
while (url) {
  const response = await fetch(url, {
    headers: { 'Authorization': 'Bearer your_api_key_here' },
  });
  const data = await response.json();
 
  // process data.data ...
 
  url = data.pagination.next_page_url;
}

Field	Description
`pagination.current_page`	Current page
`pagination.last_page`	Total number of pages
`pagination.total`	Total vacancy count
`pagination.next_page_url`	URL for next page, `null` if last page
`pagination.prev_page_url`	URL for previous page, `null` if first page

Translated Fields

The following fields are returned in the requested locale:

category
city
type
salary_type

Quickstart Error Codes