Read a public career posting

GET/workforce/careers/postings/{publicSlug}

Returns a currently active published posting whose requisition remains open and whose closing time has not passed. The public response exposes organization and role copy plus the privacy-notice version required for an application. This read is intentionally public and does not require authentication.

Authentication

A Hallify account session is not required. Follow this operation’s prerequisites and restrictions.

Connection guide

Parameters

publicSlugPath · Required: Stable public slug identifying the published career posting; it is not a candidate credential.
string
Full definition
{ "type": "string", "example": "example" }

Responses

200Public posting details for a role that is currently accepting applications.

PublicCareerPostingDto

Full definition

{
  "$ref": "#/components/schemas/PublicCareerPostingDto"
}

Example response · 200 · application/json

{
  "publicSlug": "example-slug",
  "organizationName": "Example name",
  "title": "Example title",
  "summary": "Synthetic example",
  "description": "Synthetic example",
  "locationText": "example",
  "privacyNoticeVersion": "example"
}

Schemas

PublicCareerPostingDto

Public posting details for a role that is currently accepting applications.

publicSlugRequired: Public slug for public career posting.
string
Full definition
{ "type": "string", "description": "Public slug for public career posting.", "example": "example-slug" }
organizationNameRequired: Human-readable organization name for public career posting.
string
Full definition
{ "type": "string", "description": "Human-readable organization name for public career posting.", "example": "Example name" }
titleRequired: Human-readable title shown for public career posting.
string
Full definition
{ "type": "string", "description": "Human-readable title shown for public career posting.", "example": "Example title" }
summaryRequired: Concise human-readable summary of public career posting.
string
Full definition
{ "type": "string", "description": "Concise human-readable summary of public career posting.", "example": "Synthetic example" }
descriptionRequired: Human-readable description of public career posting.
string
Full definition
{ "type": "string", "description": "Human-readable description of public career posting.", "example": "Synthetic example" }
locationTextRequired: Location text for public career posting.
string
Full definition
{ "type": "string", "description": "Location text for public career posting.", "example": "example" }
closesAtOptional: Timestamp recording when closes occurred for public career posting. Null means no value is recorded for this representation.
string · date-time · null
Full definition
{ "type": "string", "nullable": true, "description": "Timestamp recording when closes occurred for public career posting. Null means no value is recorded for this representation.", "format": "date-time", "example": "2026-01-15T12:00:00.000Z" }
privacyNoticeVersionRequired: Privacy notice version for public career posting.
string
Full definition
{ "type": "string", "description": "Privacy notice version for public career posting.", "example": "example" }

Full definition

{
  "type": "object",
  "properties": {
    "publicSlug": {
      "type": "string",
      "description": "Public slug for public career posting.",
      "example": "example-slug"
    },
    "organizationName": {
      "type": "string",
      "description": "Human-readable organization name for public career posting.",
      "example": "Example name"
    },
    "title": {
      "type": "string",
      "description": "Human-readable title shown for public career posting.",
      "example": "Example title"
    },
    "summary": {
      "type": "string",
      "description": "Concise human-readable summary of public career posting.",
      "example": "Synthetic example"
    },
    "description": {
      "type": "string",
      "description": "Human-readable description of public career posting.",
      "example": "Synthetic example"
    },
    "locationText": {
      "type": "string",
      "description": "Location text for public career posting.",
      "example": "example"
    },
    "closesAt": {
      "type": "string",
      "nullable": true,
      "description": "Timestamp recording when closes occurred for public career posting. Null means no value is recorded for this representation.",
      "format": "date-time",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "privacyNoticeVersion": {
      "type": "string",
      "description": "Privacy notice version for public career posting.",
      "example": "example"
    }
  },
  "required": [
    "publicSlug",
    "organizationName",
    "title",
    "summary",
    "description",
    "locationText",
    "privacyNoticeVersion"
  ],
  "description": "Public posting details for a role that is currently accepting applications.",
  "example": {
    "publicSlug": "example-slug",
    "organizationName": "Example name",
    "title": "Example title",
    "summary": "Synthetic example",
    "description": "Synthetic example",
    "locationText": "example",
    "privacyNoticeVersion": "example"
  }
}