Stages, application forms and what the caller may do (hr:recruiting:* or named on a posting)
GET /api/hr/v1/recruiting/bootstrap
Module: HR · operationId: getRecruitingBootstrap · Tag: Recruiting · Auth: access token (Authorization: Bearer <accessToken>)
canManage is hr:recruiting:manage, canReadAll hr:recruiting:read or more; people named on the access
list of a posting (or heading its org unit) get onAnyPosting. settings only for hr:recruiting:manage.
Everybody else 403.
Responses
- 200 Configuration (
application/json) - 403 Error (
application/json)
Fields of the 200 answer:
canManage(boolean): The caller holds hr:recruiting:managecanReadAll(boolean): The caller sees every postingformTemplates(array of ApplicationForm): Application form templatesname(string, required): Name of the form (max length 200)archived(boolean): Archived: no longer offered for new data, kept for existing datacreatedAt(string (date-time), read-only): When the application form was createddescription(string): Description of the form (max length 2000)fields(array of ApplicationFormField): Questions of the form 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
id(string (uuid), read-only): Id of the application formupdatedAt(string (date-time), read-only): When the application form was last changedversion(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
onAnyPosting(boolean): The caller is named on the access list of a postingsettings(RecruitingSettings)career(CareerSite): The tenant's public careers page on its host (https://<subdomain>.<tenant host domain>/karriere). Publishing it needs the tenant's subdomain (HR settings;400fieldsubdomain) and a recruiting mailbox (409 no_mailbox).color(string): Accent colour #rrggbb; empty for the defaultcompany(string): The employer named on the page and in the postings' structured data (max length 200)enabled(boolean): The page and the public API answer for the tenant's subdomainintro(string): Markdown above the postings (max length 20000)origins(array of string): Websites (https://host) that may embed the list of postingssubdomain(string, read-only): The tenant's subdomain (HR settings), the address of the page; empty while the tenant has nonetitle(string): Title of the careers page (max length 200)url(string, read-only): The page; empty without a subdomain (or where the platform has no tenant hosts)
consentText(string): The data-protection consent applicants accept (max length 5000)consentVersion(integer, read-only): Version of the consent text; counts its changesfromName(string): Sender name and signature of applicant mail (max length 200)mailboxId(string): The comms mailbox (consumer recruiting) applicant mail is sent from and answered to; empty: no applicant mailprivacyUrl(string): https link to the privacy noticeretentionDays(integer): Rejected, withdrawn and hired applications are deleted this long after they closed (default 183, AGG) (max 3650)talentPoolMonths(integer): How long applications of people who agreed to the talent pool are kept (max 60)updatedAt(string (date-time), read-only): When the settings were last changedupdatedBy(string, read-only): Who last changed the settings (e-mail)version(integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
stages(array of RecruitingStage): Stages of the pipelinename(string, required): Name of the stage (max length 100)phase(string, required): Phase of the stage; rules look only at the phase (one ofnew,active,hired,rejected,withdrawn)archived(boolean): Archived: no longer offered, kept for existing applicationsid(string (uuid)): Empty for a new stageposition(integer, read-only): Position in the pipeline
Example 200 answer:
{
"canManage": true,
"canReadAll": true,
"formTemplates": [
{
"archived": false,
"createdAt": "2026-09-01T09:00:00Z",
"description": "Zusatzfragen für Stellen in Technik und Service Desk",
"fields": [
{
"key": "fruehester_start",
"kind": "date",
"label": "Ab wann können Sie bei uns starten?",
"required": true
}
],
"id": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
"name": "Technische Stellen",
"updatedAt": "2026-09-15T13:20:00Z",
"version": 2
}
],
"onAnyPosting": true,
"settings": {
"consentVersion": 2,
"fromName": "Muster IT-Systemhaus GmbH – Personal",
"mailboxId": "5a7c9e1a-3c5e-4a7c-8e1a-3c5e7a9c1e91",
"privacyUrl": "https://www.muster-it.example/datenschutz",
"retentionDays": 183,
"talentPoolMonths": 12,
"version": 4
},
"stages": [
{
"archived": false,
"id": "6c8e0a2c-4e6a-4c8e-8a2c-4e6a8c0e2a82",
"name": "Eingegangen",
"phase": "new",
"position": 1
},
{
"archived": false,
"id": "8e0a2c4e-6a8c-4e0a-9c4e-6a8c0e2a4c83",
"name": "In Prüfung",
"phase": "active",
"position": 2
},
{
"archived": false,
"id": "0a2c4e6a-8c0e-4a2c-8e6a-8c0e2a4c6e84",
"name": "Interview",
"phase": "active",
"position": 3
},
{
"archived": false,
"id": "2c4e6a8c-0e2a-4c4e-9a8c-0e2a4c6e8a85",
"name": "Angebot",
"phase": "active",
"position": 4
},
{
"archived": false,
"id": "4e6a8c0e-2a4c-4e6a-8c0e-2a4c6e8a0c86",
"name": "Eingestellt",
"phase": "hired",
"position": 5
},
{
"archived": false,
"id": "6a8c0e2a-4c6e-4a8c-9e2a-4c6e8a0c2e87",
"name": "Abgesagt",
"phase": "rejected",
"position": 6
},
{
"archived": false,
"id": "8c0e2a4c-6e8a-4c0e-8a4c-6e8a0c2e4a88",
"name": "Zurückgezogen",
"phase": "withdrawn",
"position": 7
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/bootstrap' \
-H "Authorization: Bearer $ACCESS_TOKEN"