The open postings of a careers page (public)
GET /api/hr/v1/careers/{subdomain}/postings
Module: HR · operationId: listCareerPostings · Tag: Careers · Auth: none
Published postings inside their publication window, newest first. Needs no token.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
subdomain |
path | string | yes | The tenant's subdomain, the address of its careers page (case-insensitive) |
Responses
- 200 The postings (
application/json) - 404 Error (
application/json) - 429 Error (
application/json)
Fields of the 200 answer:
items(array of CareerPosting): Open postings of the pageemploymentType(string): Kind of employment (one offull_time,part_time,mini_job,apprenticeship,internship,working_student,freelance)location(string): Place of worknumber(integer): The posting number (S-4 → 4), used in the pathspublishedAt(string (date-time)): When the posting was publishedsalaryCurrency(string): Currency of the salary (ISO 4217)salaryMax(integer): Upper end of the salary rangesalaryMin(integer): Lower end of the salary rangesalaryPeriod(string): Period the salary refers to (one ofyear,month,hour)startDate(string (date)): Start date (YYYY-MM-DD), if giventitle(string): Title of the postingvalidThrough(string (date-time)): End of the publication windowworkplace(string): Where the work is done (one ofonsite,hybrid,remote)
Example 200 answer:
{
"items": [
{
"employmentType": "full_time",
"location": "Regensburg",
"number": 2,
"publishedAt": "2026-10-05T07:00:00Z",
"salaryCurrency": "EUR",
"salaryMax": 46000,
"salaryMin": 38000,
"salaryPeriod": "year",
"startDate": "2026-12-01",
"title": "Vertriebsmitarbeiter:in Innendienst (m/w/d)",
"workplace": "onsite"
},
{
"employmentType": "full_time",
"location": "Regensburg",
"number": 1,
"publishedAt": "2026-10-01T07:00:00Z",
"salaryCurrency": "EUR",
"salaryMax": 58000,
"salaryMin": 48000,
"salaryPeriod": "year",
"startDate": "2027-01-01",
"title": "Systemadministrator:in (m/w/d) Microsoft 365",
"workplace": "hybrid"
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/careers/muster-gmbh/postings'