ConnectCloud Developers

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:

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

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

View as Markdown · Interactive reference · OpenAPI