## The open postings of a careers page (public)

`GET /api/hr/v1/careers/{subdomain}/postings`

Module: HR · operationId: `listCareerPostings` · Tag: Careers · Auth: none

Published postings inside their publication window, newest first. Needs no token.

### 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 postings (`application/json`)
- **404** Error (`application/json`)
- **429** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of CareerPosting): Open postings of the page
  - `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`)

Example 200 answer:

```json
{
  "items": [
    {
      "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"
    }
  ]
}
```

### Example request

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