Job Positions

Retrieve the job positions configured in your company account. Job positions are created and managed through the platform dashboard; the API provides read-only access.

GET/v1/job-positions

Returns a paginated list of job positions belonging to your company.

Scope: read:jobs | Rate limit: reads (40 requests / 60s)

Query Parameters

Parameter	Type	Required	Description
`limit`	`number`	Optional	Number of results to return. Min 1, max 200. Default: 50.
`cursor`	`string`	Optional	Pagination cursor from a previous response.
`privacy`	`string`	Optional	Filter by privacy setting. Valid values: `"public"`, `"private"`.

curl https://api.celper.ai/v1/job-positions?limit=10 -H "X-API-Key: celp_your_api_key_here"

200Success

{
  "success": true,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": [
    {
      "id": "pos_abc123",
      "position": "Senior Developer",
      "department": "Engineering",
      "location": "Vilnius, Lithuania",
      "type": "full-time",
      "candidateCount": 42,
      "createdAt": "2026-03-15T09:30:00.000Z"
    },
    {
      "id": "pos_def456",
      "position": "Product Manager",
      "department": "Product",
      "location": "Remote",
      "type": "full-time",
      "candidateCount": 18,
      "createdAt": "2026-03-10T14:00:00.000Z"
    }
  ],
  "pagination": {
    "cursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTAzLTEwIn0",
    "hasMore": true
  }
}

401Unauthorized

403Insufficient scope

GET/v1/job-positions/{jobPositionId}

Returns detailed information about a single job position, including its description, requirements, and interview configuration.

Scope: read:jobs | Rate limit: reads (40 requests / 60s)

Path Parameters

Parameter	Type	Required	Description
`jobPositionId`	`string`	Required	The unique identifier of the job position.

curl https://api.celper.ai/v1/job-positions/pos_abc123 -H "X-API-Key: celp_your_api_key_here"

200Success

{
  "success": true,
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "id": "pos_abc123",
    "position": "Senior Developer",
    "department": "Engineering",
    "location": "Vilnius, Lithuania",
    "type": "full-time",
    "salary": 5000,
    "currency": "EUR",
    "privacy": "public",
    "description": "We are looking for an experienced developer to join our engineering team...",
    "experience": "3-5 years",
    "remote": true,
    "requirements": [
      "Strong experience with TypeScript and React",
      "Familiarity with cloud services (GCP or AWS)",
      "Excellent communication skills"
    ],
    "benefits": [
      "Flexible working hours",
      "Health insurance",
      "Annual learning budget"
    ],
    "conversationVersion": "v2",
    "interviewLanguages": [
      "en",
      "lt"
    ],
    "createdAt": "2026-03-15T09:30:00.000Z"
  }
}

404Not found