Docs
API reference

List job descriptions

GET
/api/v1/job-descriptions

Discover saved jobs so your integration can attach resumes to an existing role instead of copying job text into every request.

Before you call

Use job-descriptions:read. By default only ACTIVE jobs are listed; search matches titles/companies. Archived jobs can be listed explicitly.

Required scope: job-descriptions:read.

What happens next

Save the selected job ID and fetch its full description. Follow nextCursor with unchanged search/status filters; null means the end.

Recovery

Archived jobs cannot admit new work. If a role disappears, refresh the list and ask a workspace user to confirm the intended job. This API does not create or edit jobs.

Follow the complete workflow · Errors and retries

Authorization

ApiKey
headerAuthorizationBearer <token>

Query Parameters

limit?integer

Page size, 1–100; defaults to 25.

Range1 <= value <= 100
Default25
cursor?string

Opaque cursor from the previous page. Repeat all filters unchanged. Never decode or construct a cursor yourself.

Length1 <= length <= 2048
status?string

Current state of the surrounding resource or finding. Use the documented enum and the operation's workflow explanation.

Default"ACTIVE"
Value in"ACTIVE""ARCHIVED"
search?string

Search saved job titles/companies, 1–120 characters after trimming.

Length1 <= length <= 120

Response Body

Save the selected job ID and fetch its full description. Follow nextCursor with unchanged search/status filters; null means the end.

application/json
  1. response
data*
# Set PROBB_URL and PROBB_API_KEY. Replace RESOURCE_ID if present.curl --fail-with-body -X GET "$PROBB_URL/api/v1/job-descriptions" \  -H "Authorization: Bearer $PROBB_API_KEY"
{  "data": {    "items": [      {        "id": "job_example",        "title": "Backend Engineer",        "company": "Example Company",        "team": "Platform",        "location": "Remote",        "level": "Senior",        "employmentType": "FULL_TIME",        "status": "ACTIVE",        "revision": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",        "createdAt": "2026-09-29T12:00:00.000Z",        "updatedAt": "2026-09-29T12:00:00.000Z"      }    ],    "nextCursor": null  }}