ConnectCloud Developers

A careers page with its open postings (public)

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

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

Needs no token. Unknown subdomains and switched-off pages answer 404. Limited to 5 requests per second per client (bursts up to 50).

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 page and its open postings, newest first (application/json)
  • 404 Error (application/json)
  • 429 Error (application/json)

Fields of the 200 answer:

  • postings (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)
  • site (CareerPublicSite)
    • color (string): Accent colour (#rrggbb), omitted for the default
    • company (string): Name of the employer
    • intro (string): Markdown
    • origins (array of string): Websites that may embed the list
    • privacyUrl (string): Link to the privacy policy
    • title (string): Title of the careers page

Example 200 answer:

{
  "postings": [
    {
      "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"
    }
  ],
  "site": {
    "color": "#0a7c66",
    "company": "Muster IT-Systemhaus GmbH",
    "intro": "Wir betreuen mit rund 25 Kolleginnen und Kollegen die IT von Mittelstand, Praxen und Kanzleien in Ostbayern.",
    "privacyUrl": "https://www.muster-it.example/datenschutz",
    "title": "Karriere bei Muster IT"
  }
}

Example request

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

View as Markdown · Interactive reference · OpenAPI