## Job postings the caller sees (tenant:access; hr:recruiting:* sees all, others the postings they are named on)

`GET /api/hr/v1/recruiting/postings`

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

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `status` | query | string |  | Without it every posting but archived ones (one of `draft`, `published`, `closed`, `archived`) |
| `q` | query | string |  | Searches title and location |
| `limit` | query | integer |  | 1–200; another value is a 400 invalid. (default `50`; max 200) |
| `offset` | query | integer |  | (default `0`) |

### Responses

- **200** A page of postings (`application/json`)

Fields of the 200 answer:

- `items` (array of JobPosting): Postings of this page
- `total` (integer): Number of all matching postings

Example 200 answer:

```json
{
  "items": [
    {
      "contactEmployeeId": "9b1d3f5a-7c9e-4b1d-8f3a-5c7e9b1d3f2e",
      "counts": {
        "active": 3,
        "new": 1
      },
      "createdAt": "2026-09-29T14:10:00Z",
      "createdBy": "tobias.hartl@muster-it.example",
      "employmentType": "full_time",
      "id": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
      "location": "Regensburg",
      "number": 1,
      "orgUnitId": "2e4a6c8e-0a2c-4e4a-8c6e-0a2c4e6a8c72",
      "publishedAt": "2026-10-01T07:00:00Z",
      "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"
    },
    {
      "counts": {
        "active": 1,
        "new": 2
      },
      "createdAt": "2026-10-02T11:00:00Z",
      "createdBy": "andrea.peschke@muster-it.example",
      "employmentType": "full_time",
      "id": "6c8e0a2c-4e6a-4c8e-9a2c-4e6a8c0e2a93",
      "location": "Regensburg",
      "number": 2,
      "orgUnitId": "5a7c9e1a-3c5e-4a7c-9e1a-3c5e7a9c1e73",
      "publishedAt": "2026-10-05T07:00:00Z",
      "role": "viewer",
      "salaryCurrency": "EUR",
      "salaryMax": 46000,
      "salaryMin": 38000,
      "salaryPeriod": "year",
      "startDate": "2026-12-01",
      "status": "published",
      "title": "Vertriebsmitarbeiter:in Innendienst (m/w/d)",
      "updatedAt": "2026-10-05T07:00:00Z",
      "version": 2,
      "workplace": "onsite"
    }
  ],
  "total": 2
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/postings' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
