ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI