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 pageanswers(object): Answers to the form questions by question keycloseReason(string): Reason given when it was closedclosedAt(string (date-time)): When it was rejected, withdrawn or hiredconsentAt(string (date-time)): When the applicant gave the consentconsentVersion(integer): Version of the consent text the applicant accepted (0: none)coverLetter(string): Cover letter textcreatedAt(string (date-time)): When the application was createddeleteAfter(string (date-time)): When the application is deletedemail(string): Applicant's e-mail addressemployeeId(string (uuid)): The employee created from it (hired)files(array of ApplicationFile): Files of the application (single reads)contentType(string): Media type of the filecreatedAt(string (date-time)): When the file was addeddocumentId(string): Id of the document in DMSfieldKey(string): Key of the form question the file answers (role answer)fileName(string): File nameid(string (uuid)): Id of the filerole(string): What the file is (CV, attachment, answer to a file question, mail attachment) (one ofcv,attachment,answer,mail)scanStatus(string): Result of the malware scan; content is served only when CLEAN (one ofPENDING,CLEAN,INFECTED,SKIPPED,FAILED)sizeBytes(integer (int64)): Size in bytes
firstName(string): Applicant's first nameid(string (uuid)): Id of the applicationlastName(string): Applicant's last namenextInterview(string (date-time)): Start of the next interview, if anynumber(integer): Number of the application, unique in the tenantphase(string): Phase of the current stage (one ofnew,active,hired,rejected,withdrawn)phone(string): Applicant's phone numberpostingId(string (uuid)): Id of the posting applied topostingTitle(string): Title of the postingrating(object): Summary of the reviewers' ratingsaverage(number): Average score (1–5)count(integer): Number of ratingsmine(integer): The caller's score (0 not rated)
role(string): The caller's role on the posting (one ofviewer,reviewer,manager)source(string): How the application arrived (one ofmanual,portal,api)stageChangedAt(string (date-time)): When the application entered its current stagestageId(string (uuid)): Id of the current pipeline stagetalentPoolUntil(string (date-time)): Kept in the talent pool until then (applicant agreed)updatedAt(string (date-time)): When the application was last changedversion(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:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/recruiting/applications' \
-H "Authorization: Bearer $ACCESS_TOKEN"