ConnectCloud Developers

An open posting with its application form (public)

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

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

The description (Markdown), the questions of the form after the fixed fields and the consent text applicants accept (send its version as consentVersion). Closed postings and postings outside their window answer 404.

Parameters

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

Responses

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

Fields of the 200 answer:

  • 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)
  • consent (object): The data-protection consent applicants accept
    • privacyUrl (string): Link to the privacy policy
    • text (string): Text of the consent
    • version (integer): Send it as consentVersion
  • contact (string): Name of the contact person
  • description (string): Markdown
  • form (array of ApplicationFormField): The questions after the fixed fields
    • key (string, required): Lower-case letters, digits, - or _; not a core field (first_name, last_name, email, phone, cover_letter, cv, attachments)
    • kind (string, required): Kind of answer (one of text, longtext, number, date, bool, select, multiselect, url, file)
    • label (string, required): Question text (max length 300)
    • help (string): Help text shown with the question (max length 1000)
    • options (array of object): Choices of select and multiselect questions
      • label (string): Display text of the choice
      • value (string): Stored value of the choice
    • required (boolean): An answer is required
  • maxFileBytes (integer): Largest size of one file in bytes
  • maxFiles (integer): Most files one application may carry
  • 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
  • talentPoolMonths (integer): > 0: applicants may agree to be kept in the talent pool this long

Example 200 answer:

{
  "consent": {
    "dass die Muster IT-Systemhaus GmbH meine Angaben zur Bearbeitung meiner Bewerbung speichert und verarbeitet.": "",
    "privacyUrl": "https://www.muster-it.example/datenschutz",
    "text": "Ich bin einverstanden",
    "version": 2
  },
  "contact": "Tobias Hartl",
  "description": "## Ihre Aufgaben\n- Betrieb und Weiterentwicklung der Microsoft-365-Umgebungen unserer Kunden (Exchange Online, Teams, SharePoint, Intune)\n- Migrationen von On-Premises-Servern in die Cloud",
  "employmentType": "full_time",
  "form": [
    {
      "key": "fruehester_start",
      "kind": "date",
      "label": "Ab wann können Sie bei uns starten?",
      "required": true
    },
    {
      "key": "zertifizierungen",
      "kind": "multiselect",
      "label": "Welche Microsoft-Zertifizierungen haben Sie?",
      "options": [
        {
          "label": "MS-102",
          "value": "ms_102"
        },
        {
          "label": "MD-102",
          "value": "md_102"
        },
        {
          "label": "AZ-104",
          "value": "az_104"
        }
      ],
      "required": false
    }
  ],
  "location": "Regensburg",
  "maxFileBytes": 10485760,
  "maxFiles": 10,
  "number": 1,
  "publishedAt": "2026-10-01T07:00:00Z",
  "salaryCurrency": "EUR",
  "salaryMax": 58000,
  "salaryMin": 48000,
  "salaryPeriod": "year",
  "site": {
    "color": "#0a7c66",
    "company": "Muster IT-Systemhaus GmbH",
    "privacyUrl": "https://www.muster-it.example/datenschutz",
    "title": "Karriere bei Muster IT"
  },
  "startDate": "2027-01-01",
  "talentPoolMonths": 12,
  "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/1'

View as Markdown · Interactive reference · OpenAPI