Job postings the caller sees (tenant:access; hr:recruiting:* sees all, others the postings they are named on)
GET /api/hr/v1/recruiting/postings
Module: HR · operationId: listJobPostings · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
status |
query | string | Without it every posting but archived ones (one of draft, published, closed, archived) |
|
q |
query | string | Searches title and location | |
limit |
query | integer | 1–200; another value is a 400 invalid. (default 50; max 200) |
|
offset |
query | integer | (default 0) |
Responses
- 200 A page of postings (
application/json)
Fields of the 200 answer:
items(array of JobPosting): Postings of this pagetotal(integer): Number of all matching postings
Example 200 answer:
{
"items": [
{
"contactEmployeeId": "9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e",
"counts": {
"active": 3,
"new": 1
},
"createdAt": "2026-09-29T14:10:00Z",
"createdBy": "tobias.hartl@muster-it.example",
"employmentType": "full_time",
"id": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
"location": "Regensburg",
"number": 1,
"orgUnitId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
"publishedAt": "2026-10-01T07:00:00Z",
"role": "manager",
"salaryCurrency": "EUR",
"salaryMax": 58000,
"salaryMin": 48000,
"salaryPeriod": "year",
"startDate": "2027-01-01",
"status": "published",
"title": "Systemadministrator:in (m/w/d) Microsoft 365",
"updatedAt": "2026-10-01T07:00:00Z",
"version": 3,
"workplace": "hybrid"
},
{
"counts": {
"active": 1,
"new": 2
},
"createdAt": "2026-10-02T11:00:00Z",
"createdBy": "andrea.peschke@muster-it.example",
"employmentType": "full_time",
"id": "6c8e0a2c-4e6a-4c8e-9a2c-4e6a8c0e2a93",
"location": "Regensburg",
"number": 2,
"orgUnitId": "5a7c9e1a-3c5e-4a7c-9e1a-3c5e7a9c1e73",
"publishedAt": "2026-10-05T07:00:00Z",
"role": "viewer",
"salaryCurrency": "EUR",
"salaryMax": 46000,
"salaryMin": 38000,
"salaryPeriod": "year",
"startDate": "2026-12-01",
"status": "published",
"title": "Vertriebsmitarbeiter:in Innendienst (m/w/d)",
"updatedAt": "2026-10-05T07:00:00Z",
"version": 2,
"workplace": "onsite"
}
],
"total": 2
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/postings' \
-H "Authorization: Bearer $ACCESS_TOKEN"