A careers page with its open postings (public)
GET /api/hr/v1/careers/{subdomain}
Module: HR · operationId: getCareerSite · Tag: Careers · Auth: none
Needs no token. Unknown subdomains and switched-off pages answer 404. Limited to 5 requests per second per client (bursts up to 50).
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 page and its open postings, newest first (
application/json) - 404 Error (
application/json) - 429 Error (
application/json)
Fields of the 200 answer:
postings(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)
site(CareerPublicSite)color(string): Accent colour (#rrggbb), omitted for the defaultcompany(string): Name of the employerintro(string): Markdownorigins(array of string): Websites that may embed the listprivacyUrl(string): Link to the privacy policytitle(string): Title of the careers page
Example 200 answer:
{
"postings": [
{
"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"
}
],
"site": {
"color": "#0a7c66",
"company": "Muster IT-Systemhaus GmbH",
"intro": "Wir betreuen mit rund 25 Kolleginnen und Kollegen die IT von Mittelstand, Praxen und Kanzleien in Ostbayern.",
"privacyUrl": "https://www.muster-it.example/datenschutz",
"title": "Karriere bei Muster IT"
}
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/careers/muster-gmbh'