An open posting with its application form (public)
GET /api/hr/v1/careers/{subdomain}/postings/{number}
Module: HR · operationId: getCareerPosting · Tag: Careers · Auth: none
The description (Markdown), the questions of the form after the fixed fields and the consent text applicants accept (send its version as consentVersion). Closed postings and postings outside their window answer 404.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
subdomain |
path | string | yes | The tenant's subdomain, the address of its careers page (case-insensitive) |
number |
path | integer | yes | The posting number (S-4 → 4) |
Responses
- 200 The posting (
application/json) - 404 Error (
application/json) - 429 Error (
application/json)
Fields of the 200 answer:
employmentType(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)consent(object): The data-protection consent applicants acceptprivacyUrl(string): Link to the privacy policytext(string): Text of the consentversion(integer): Send it as consentVersion
contact(string): Name of the contact persondescription(string): Markdownform(array of ApplicationFormField): The questions after the fixed fieldskey(string, required): Lower-case letters, digits, - or _; not a core field (first_name, last_name, email, phone, cover_letter, cv, attachments)kind(string, required): Kind of answer (one oftext,longtext,number,date,bool,select,multiselect,url,file)label(string, required): Question text (max length 300)help(string): Help text shown with the question (max length 1000)options(array of object): Choices of select and multiselect questionslabel(string): Display text of the choicevalue(string): Stored value of the choice
required(boolean): An answer is required
maxFileBytes(integer): Largest size of one file in bytesmaxFiles(integer): Most files one application may carrysite(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
talentPoolMonths(integer): > 0: applicants may agree to be kept in the talent pool this long
Example 200 answer:
{
"consent": {
"dass die Muster IT-Systemhaus GmbH meine Angaben zur Bearbeitung meiner Bewerbung speichert und verarbeitet.": "",
"privacyUrl": "https://www.muster-it.example/datenschutz",
"text": "Ich bin einverstanden",
"version": 2
},
"contact": "Tobias Hartl",
"description": "## Ihre Aufgaben\n- Betrieb und Weiterentwicklung der Microsoft-365-Umgebungen unserer Kunden (Exchange Online, Teams, SharePoint, Intune)\n- Migrationen von On-Premises-Servern in die Cloud",
"employmentType": "full_time",
"form": [
{
"key": "fruehester_start",
"kind": "date",
"label": "Ab wann können Sie bei uns starten?",
"required": true
},
{
"key": "zertifizierungen",
"kind": "multiselect",
"label": "Welche Microsoft-Zertifizierungen haben Sie?",
"options": [
{
"label": "MS-102",
"value": "ms_102"
},
{
"label": "MD-102",
"value": "md_102"
},
{
"label": "AZ-104",
"value": "az_104"
}
],
"required": false
}
],
"location": "Regensburg",
"maxFileBytes": 10485760,
"maxFiles": 10,
"number": 1,
"publishedAt": "2026-10-01T07:00:00Z",
"salaryCurrency": "EUR",
"salaryMax": 58000,
"salaryMin": 48000,
"salaryPeriod": "year",
"site": {
"color": "#0a7c66",
"company": "Muster IT-Systemhaus GmbH",
"privacyUrl": "https://www.muster-it.example/datenschutz",
"title": "Karriere bei Muster IT"
},
"startDate": "2027-01-01",
"talentPoolMonths": 12,
"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/1'