ConnectCloud Developers

The open postings of a careers page (public)

GET /api/hr/v1/careers/{subdomain}/postings

Module: HR · operationId: listCareerPostings · Tag: Careers · Auth: none

Published postings inside their publication window, newest first. Needs no token.

Parameters

Name In Type Required Description
subdomain path string yes The tenant's subdomain, the address of its careers page (case-insensitive)

Responses

  • 200 The postings (application/json)
  • 404 Error (application/json)
  • 429 Error (application/json)

Fields of the 200 answer:

  • items (array of CareerPosting): Open postings of the page
    • employmentType (string): Kind of employment (one of full_time, part_time, mini_job, apprenticeship, internship, working_student, freelance)
    • location (string): Place of work
    • number (integer): The posting number (S-4 → 4), used in the paths
    • publishedAt (string (date-time)): When the posting was published
    • salaryCurrency (string): Currency of the salary (ISO 4217)
    • salaryMax (integer): Upper end of the salary range
    • salaryMin (integer): Lower end of the salary range
    • salaryPeriod (string): Period the salary refers to (one of year, month, hour)
    • startDate (string (date)): Start date (YYYY-MM-DD), if given
    • title (string): Title of the posting
    • validThrough (string (date-time)): End of the publication window
    • workplace (string): Where the work is done (one of onsite, hybrid, remote)

Example 200 answer:

{
  "items": [
    {
      "employmentType": "full_time",
      "location": "Regensburg",
      "number": 2,
      "publishedAt": "2026-10-05T07:00:00Z",
      "salaryCurrency": "EUR",
      "salaryMax": 46000,
      "salaryMin": 38000,
      "salaryPeriod": "year",
      "startDate": "2026-12-01",
      "title": "Vertriebsmitarbeiter:in Innendienst (m/w/d)",
      "workplace": "onsite"
    },
    {
      "employmentType": "full_time",
      "location": "Regensburg",
      "number": 1,
      "publishedAt": "2026-10-01T07:00:00Z",
      "salaryCurrency": "EUR",
      "salaryMax": 58000,
      "salaryMin": 48000,
      "salaryPeriod": "year",
      "startDate": "2027-01-01",
      "title": "Systemadministrator:in (m/w/d) Microsoft 365",
      "workplace": "hybrid"
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/hr/v1/careers/muster-gmbh/postings'

View as Markdown · Interactive reference · OpenAPI