## A careers page with its open postings (public)

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

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

Needs no token. Unknown subdomains and switched-off pages answer `404`. Limited to 5 requests per second per client (bursts up to 50).

### 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 page and its open postings, newest first (`application/json`)
- **404** Error (`application/json`)
- **429** Error (`application/json`)

Fields of the 200 answer:

- `postings` (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`)
- `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

Example 200 answer:

```json
{
  "postings": [
    {
      "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"
    }
  ],
  "site": {
    "color": "#0a7c66",
    "company": "Muster IT-Systemhaus GmbH",
    "intro": "Wir betreuen mit rund 25 Kolleginnen und Kollegen die IT von Mittelstand, Praxen und Kanzleien in Ostbayern.",
    "privacyUrl": "https://www.muster-it.example/datenschutz",
    "title": "Karriere bei Muster IT"
  }
}
```

### Example request

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