List the company's job listings
Scope job-listings:read. Items carry the summary fields only; the others are null.
Scope job-listings:read. Items carry the summary fields only; the others are null.
Authorization
ApiKeyAuth X-API-Key<token>
API key issued by Jobiflow, created by a company owner under Settings, API keys.
In: header
Query Parameters
status?string
Filter by listing status
Value in
- "DRAFT"
- "ACTIVE"
- "CLOSED"
- "ARCHIVED"
positionType?array<>
Filter by one or more position types (repeatable)
workPlaceType?array<>
Filter by one or more workplace types (repeatable)
publishedFrom?string
Published on or after (ISO 8601 local date-time, e.g. 2026-01-01T00:00:00)
Format
date-timepublishedTo?string
Published on or before
Format
date-timecreatedFrom?string
Created on or after
Format
date-timecreatedTo?string
Created on or before
Format
date-timereferenceNumber?string
Your reference number (exact match)
query?string
Free-text search over position and description
page?integer
Zero-based page index (negative values count as 0)
Default
0size?integer
Items per page, 1 to 100 (values outside are clamped)
Default
20Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/job-listings"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "status": "ACTIVE", "sectorId": "3274bbb4-3f99-4800-8405-d01f8a71a05d", "position": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "positionType": "FULL_TIME", "workPlaceType": "HYBRID", "address": { "street": "string", "city": "string", "state": "string", "country": "string", "postalCode": "string", "latitude": 0.1, "longitude": 0.1 }, "isStartDate": true, "startDate": "2019-08-24", "jobDescription": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "requirementsSummary": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "personalQualitiesSummary": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "skills": [ { "value": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "type": "SKILL", "expertType": "INTERMEDIATE", "languageProficiency": "B2", "drivingClass": "B" } ], "currency": "string", "salaryBase": 0, "isSalaryMax": true, "salaryMax": 0, "salaryType": "GROSS", "paymentInterval": "MONTHLY", "salaryDescription": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "benefits": [ { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" } ], "educationLevel": "BACHELORS", "fieldOfStudy": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "yearsOfExperience": 0, "availableForEveryCountry": true, "numberOfPositionsOpened": 0, "jobListingEndDate": "2019-08-24", "referenceNumber": "string", "hiringProcessSteps": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39", "stepOrder": 1, "stepName": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" }, "description": { "value": "string", "original": "string", "sourceLanguage": "string", "translated": true, "translationType": "AI" } } ], "jobListingTags": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39", "tagId": "f69eb9f1-ae9f-4086-b25c-c39758a43fb3" } ], "jobListingRequirements": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "jobListingId": "a7d01775-e611-4288-b8c1-442852b8ff39", "requirementText": "string" } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "expiresAt": "2019-08-24T14:15:22Z", "closedAt": "2019-08-24T14:15:22Z" } ], "pagination": { "page": 0, "size": 0, "totalElements": 0, "totalPages": 0 }}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}{ "errorCode": "string", "message": "string", "statusCode": 0, "path": "string", "timestamp": "2019-08-24T14:15:22Z", "fieldErrors": [ { "field": "string", "message": "string" } ]}