v1

latestOpenAPI 3.0.02026-07-14800227.2 KB

Recruiting

Return a list of existing positions (job openings).

This endpoint will return a paginated list of positions. The URL params will help to filter the results.

get/recruiting/positions

Query parameters

_idstring

status'Active' | 'Draft' | 'Closed' | 'Archived'

Example:Active

companyIdstring

officeIdstring

departmentIdstring

Example:Full-time

limit25 | 50 | 100

Example:25

Optional filter for pagination proposals. The maximum number of rows to retrieve which determines the size of the page. If this value is not provided then the limit will be 50. The maximum value of the limit is 100 items per page. Only are valid the following limit values: 25, 50 and 100.

offsetnumber

Example:1

Optional filter for pagination proposals. Determines the number of pages to skip when pagination is being used. If this value is not provided, by default the offset will be 1.

Response

OK. Paginated list of positions.

Example response

{
  "data": [
    {
      "_id": "67223a33a649b91cef9b6f2a",
      "jobTitle": "Marketing Manager",
      "companyId": "67223a2aa649b91cef9b65f2",
      "officeId": "67223a2ba649b91cef9b663a",
      "departmentId": "67223a2ba649b91cef9b661f",
      "positionType": "Full-time",
      "status": "Active",
      "jobDescription": {
        "html": "<div>We are looking for a Marketing expert with more than 5 years of experience...</div>"
      }
    },
    {
      "_id": "67223a33a649b91cef9b6f2b",
      "jobTitle": "Software Developer",
      "companyId": "67223a2aa649b91cef9b65f2",
      "officeId": "67223a2ba649b91cef9b663a",
      "departmentId": "67223a2ba649b91cef9b6621",
      "positionType": "Full-time",
      "status": "Active",
      "jobDescription": {
        "html": "<div>As a developer, your responsibilities will include solving bugs...</div>"
      }
    },
    {
      "_id": "67223a33a649b91cef9b6f2c",
      "jobTitle": "Customer Support Agent",
      "companyId": "67223a2aa649b91cef9b65f2",
      "officeId": "67223a2ba649b91cef9b663a",
      "departmentId": "67223a2ba649b91cef9b6620",
      "positionType": "Full-time",
      "status": "Active",
      "jobDescription": {
        "html": "<div>You will be the ears and eyes of our customers...</div>"
      }
    },
    {
      "_id": "67223a33a649b91cef9b6f2d",
      "jobTitle": "Quality Assurance Engineer",
      "companyId": "67223a2aa649b91cef9b65f2",
      "officeId": "67223a2ba649b91cef9b663a",
      "departmentId": "67223a2ba649b91cef9b6621",
      "positionType": "Full-time",
      "status": "Active",
      "jobDescription": {
        "html": "<div>As a QA Engineer, one of your functions would be to work hand-in-hand...</div>"
      }
    },
    {
      "_id": "67223a33a649b91cef9b6f2e",
      "jobTitle": "Account Executive",
      "companyId": "67223a2aa649b91cef9b65f2",
      "officeId": "67223a2ba649b91cef9b663a",
      "departmentId": "67223a2ba649b91cef9b6622",
      "positionType": "Full-time",
      "status": "Closed",
      "jobDescription": {
        "html": "<div>As our Account Executive, your mission will be to lead a high performing...</div>"
      }
    }
  ],
  "metadata": {
    "limit": 50,
    "offset": 1,
    "total": 5,
    "count": 5
  }
}