## Applications to the postings the caller sees

`GET /api/hr/v1/recruiting/applications`

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

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `postingId` | query | string (uuid) |  |  |
| `stageId` | query | string (uuid) |  |  |
| `phase` | query | string |  | Comma-separated phases, e.g. `new,active` |
| `q` | query | string |  | Searches name and e-mail |
| `talentPool` | query | boolean |  | Only applications in the talent pool |
| `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 applications (`application/json`)

Fields of the 200 answer:

- `items` (array of Application): Applications of this page
  - `answers` (object): Answers to the form questions by question key
  - `closeReason` (string): Reason given when it was closed
  - `closedAt` (string (date-time)): When it was rejected, withdrawn or hired
  - `consentAt` (string (date-time)): When the applicant gave the consent
  - `consentVersion` (integer): Version of the consent text the applicant accepted (0: none)
  - `coverLetter` (string): Cover letter text
  - `createdAt` (string (date-time)): When the application was created
  - `deleteAfter` (string (date-time)): When the application is deleted
  - `email` (string): Applicant's e-mail address
  - `employeeId` (string (uuid)): The employee created from it (hired)
  - `files` (array of ApplicationFile): Files of the application (single reads)
    - `contentType` (string): Media type of the file
    - `createdAt` (string (date-time)): When the file was added
    - `documentId` (string): Id of the document in DMS
    - `fieldKey` (string): Key of the form question the file answers (role answer)
    - `fileName` (string): File name
    - `id` (string (uuid)): Id of the file
    - `role` (string): What the file is (CV, attachment, answer to a file question, mail attachment) (one of `cv`, `attachment`, `answer`, `mail`)
    - `scanStatus` (string): Result of the malware scan; content is served only when CLEAN (one of `PENDING`, `CLEAN`, `INFECTED`, `SKIPPED`, `FAILED`)
    - `sizeBytes` (integer (int64)): Size in bytes
  - `firstName` (string): Applicant's first name
  - `id` (string (uuid)): Id of the application
  - `lastName` (string): Applicant's last name
  - `nextInterview` (string (date-time)): Start of the next interview, if any
  - `number` (integer): Number of the application, unique in the tenant
  - `phase` (string): Phase of the current stage (one of `new`, `active`, `hired`, `rejected`, `withdrawn`)
  - `phone` (string): Applicant's phone number
  - `postingId` (string (uuid)): Id of the posting applied to
  - `postingTitle` (string): Title of the posting
  - `rating` (object): Summary of the reviewers' ratings
    - `average` (number): Average score (1–5)
    - `count` (integer): Number of ratings
    - `mine` (integer): The caller's score (0 not rated)
  - `role` (string): The caller's role on the posting (one of `viewer`, `reviewer`, `manager`)
  - `source` (string): How the application arrived (one of `manual`, `portal`, `api`)
  - `stageChangedAt` (string (date-time)): When the application entered its current stage
  - `stageId` (string (uuid)): Id of the current pipeline stage
  - `talentPoolUntil` (string (date-time)): Kept in the talent pool until then (applicant agreed)
  - `updatedAt` (string (date-time)): When the application was last changed
  - `version` (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
- `total` (integer): Number of all matching applications

Example 200 answer:

```json
{
  "items": [
    {
      "consentVersion": 2,
      "createdAt": "2026-11-02T18:43:00Z",
      "email": "stefan.lindner@mail.example",
      "firstName": "Stefan",
      "id": "1c3e5a7c-9e1a-4c3e-9a5c-9e1a3c5e7a89",
      "lastName": "Lindner",
      "nextInterview": "2026-11-24T09:00:00Z",
      "number": 3,
      "phase": "active",
      "postingId": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
      "postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
      "rating": {
        "average": 3.5,
        "count": 2,
        "mine": 3
      },
      "role": "manager",
      "source": "portal",
      "stageChangedAt": "2026-11-12T10:30:00Z",
      "stageId": "0a2c4e6a-8c0e-4a2c-8e6a-8c0e2a4c6e84",
      "updatedAt": "2026-11-12T10:30:00Z",
      "version": 5
    },
    {
      "consentVersion": 2,
      "createdAt": "2026-11-01T10:12:00Z",
      "email": "katharina.reiter@mail.example",
      "firstName": "Katharina",
      "id": "7e9a1c3e-5a7c-4e9a-9c1e-5a7c9e1a3c96",
      "lastName": "Reiter",
      "number": 2,
      "phase": "active",
      "postingId": "4a6c8e0a-2c4e-4a6c-9e0a-2c4e6a8c0e81",
      "postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
      "rating": {
        "average": 4,
        "count": 1,
        "mine": 4
      },
      "role": "manager",
      "source": "manual",
      "stageChangedAt": "2026-11-05T09:00:00Z",
      "stageId": "8e0a2c4e-6a8c-4e0a-9c4e-6a8c0e2a4c83",
      "talentPoolUntil": "2027-11-02T00:00:00Z",
      "updatedAt": "2026-11-05T09:00:00Z",
      "version": 3
    }
  ],
  "total": 2
}
```

### Example request

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