## One posting with the caller's role (its access list for managers of the posting)

`GET /api/hr/v1/recruiting/postings/{id}`

Module: HR · operationId: `getJobPosting` · Tag: Recruiting · Auth: access token (`Authorization: Bearer <accessToken>`)

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** The posting (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `employmentType` (string, required): Kind of employment (one of `full_time`, `part_time`, `mini_job`, `apprenticeship`, `internship`, `working_student`, `freelance`)
- `title` (string, required): Title of the posting (max length 300)
- `contactEmployeeId` (string (uuid)): Employee id of the contact person
- `description` (string): Markdown
- `formTemplateId` (string (uuid)): Id of the application form template
- `location` (string): Place of work (max length 300)
- `orgUnitId` (string (uuid)): Heads and deputies of the unit (and the units above it) review the posting
- `publishFrom` (string (date-time)): A published posting is shown on the careers site from then on (empty: at once)
- `publishUntil` (string (date-time)): A published posting is shown on the careers site until then (empty: until closed)
- `questions` (array of ApplicationFormField): Questions of this posting after those of its form template
  - `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
- `salaryCurrency` (string): Currency of the salary (ISO 4217) (default `"EUR"`)
- `salaryMax` (integer (int64)): Upper end of the salary range
- `salaryMin` (integer (int64)): In the currency's main unit per period
- `salaryPeriod` (string): Period the salary refers to (one of `year`, `month`, `hour`; default `"year"`)
- `startDate` (string (date)): Start date (YYYY-MM-DD), empty for none
- `version` (integer): Version of the posting a change is based on
- `workplace` (string): Where the work is done (one of `onsite`, `hybrid`, `remote`; default `"onsite"`)
- `access` (array of PostingAccessEntry): Only for managers of the posting
  - `role` (string, required): viewer reads; reviewer also notes, rates and sees interviews; manager moves, rejects, hires, mails, schedules and edits the posting (one of `viewer`, `reviewer`, `manager`)
  - `subjectId` (string (uuid), required): Id of the employee, group or org unit
  - `subjectKind` (string, required): Who is named: one employee, the members of a group or of an org unit (one of `employee`, `group`, `org_unit`)
  - `includeSubunits` (boolean): org_unit only: the members of the units below it too
  - `subjectName` (string, read-only): Name of the employee, group or org unit (filled on reads)
- `closedAt` (string (date-time)): When the posting was closed
- `counts` (object): Applications per phase
- `createdAt` (string (date-time)): When the posting was created
- `createdBy` (string): Who created the posting (e-mail of the caller)
- `id` (string (uuid)): Id of the posting
- `number` (integer): Number of the posting, unique in the tenant (careers site address)
- `publishedAt` (string (date-time)): When the posting was last published
- `role` (string): The caller's role on the posting (one of `viewer`, `reviewer`, `manager`)
- `status` (string): State of the posting (one of `draft`, `published`, `closed`, `archived`)
- `updatedAt` (string (date-time)): When the posting was last changed

Example 200 answer:

```json
{
  "access": [
    {
      "role": "reviewer",
      "subjectId": "f2a4c6e8-0b2d-4f4a-8c6e-8a0c2e4b6d1c",
      "subjectKind": "employee",
      "subjectName": "Jonas Bauer"
    },
    {
      "includeSubunits": true,
      "role": "viewer",
      "subjectId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
      "subjectKind": "org_unit",
      "subjectName": "Technik"
    }
  ],
  "contactEmployeeId": "9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e",
  "counts": {
    "active": 3,
    "hired": 0,
    "new": 1,
    "rejected": 0,
    "withdrawn": 0
  },
  "createdAt": "2026-09-29T14:10:00Z",
  "createdBy": "tobias.hartl@muster-it.example",
  "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",
  "formTemplateId": "3e5a7c9e-1a3c-4e5a-9c7e-1a3c5e7a9c90",
  "id": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
  "location": "Regensburg",
  "number": 1,
  "orgUnitId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
  "publishedAt": "2026-10-01T07:00:00Z",
  "questions": [],
  "role": "manager",
  "salaryCurrency": "EUR",
  "salaryMax": 58000,
  "salaryMin": 48000,
  "salaryPeriod": "year",
  "startDate": "2027-01-01",
  "status": "published",
  "title": "Systemadministrator:in (m/w/d) Microsoft 365",
  "updatedAt": "2026-10-01T07:00:00Z",
  "version": 3,
  "workplace": "hybrid"
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/postings/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
