## 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 of `full_time`, `part_time`, `mini_job`, `apprenticeship`, `internship`, `working_student`, `freelance`)
- `location` (string): Place of work
- `number` (integer): The posting number (S-4 → 4), used in the paths
- `publishedAt` (string (date-time)): When the posting was published
- `salaryCurrency` (string): Currency of the salary (ISO 4217)
- `salaryMax` (integer): Upper end of the salary range
- `salaryMin` (integer): Lower end of the salary range
- `salaryPeriod` (string): Period the salary refers to (one of `year`, `month`, `hour`)
- `startDate` (string (date)): Start date (YYYY-MM-DD), if given
- `title` (string): Title of the posting
- `validThrough` (string (date-time)): End of the publication window
- `workplace` (string): Where the work is done (one of `onsite`, `hybrid`, `remote`)
- `consent` (object): The data-protection consent applicants accept
  - `privacyUrl` (string): Link to the privacy policy
  - `text` (string): Text of the consent
  - `version` (integer): Send it as consentVersion
- `contact` (string): Name of the contact person
- `description` (string): Markdown
- `form` (array of ApplicationFormField): The questions after the fixed fields
  - `key` (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 of `text`, `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 questions
    - `label` (string): Display text of the choice
    - `value` (string): Stored value of the choice
  - `required` (boolean): An answer is required
- `maxFileBytes` (integer): Largest size of one file in bytes
- `maxFiles` (integer): Most files one application may carry
- `site` (CareerPublicSite)
  - `color` (string): Accent colour (#rrggbb), omitted for the default
  - `company` (string): Name of the employer
  - `intro` (string): Markdown
  - `origins` (array of string): Websites that may embed the list
  - `privacyUrl` (string): Link to the privacy policy
  - `title` (string): Title of the careers page
- `talentPoolMonths` (integer): > 0: applicants may agree to be kept in the talent pool this long

Example 200 answer:

```json
{
  "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

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/careers/muster-gmbh/postings/1'
```
