Skip to main content

Get a public job

Fetch a single open, public role with its organization metadata. No authentication.

GET/api/public/portal/{orgSlug}/roles/{roleId} 🔒 No auth

Returns a single public, open role together with its organization metadata. This endpoint is public — no API key is required. The role must be public and open; otherwise a 404 is returned.

Path parameters

ParameterTypeDescription
orgSlugstringThe organization’s portal slug.
roleIdstringThe role ID.

Example request

curl https://app.talent-ray.com/api/public/portal/acme/roles/clx123abc

Response

200 OK

{
  "org": {
    "name": "Acme Inc.",
    "logo": "https://.../logo.png",
    "slug": "acme",
    "domain": "acme.com",
    "portalTheme": { "showSalary": true }
  },
  "role": {
    "id": "clx123abc",
    "name": "Senior Backend Engineer",
    "description": { },
    "department": "Engineering",
    "location": "Remote",
    "workType": "remote",
    "collarType": "white",
    "salaryMin": 90000,
    "salaryMax": 120000,
    "salaryCurrency": "EUR",
    "salaryPeriod": "year",
    "createdAt": "2026-06-01T09:00:00Z"
  }
}

Salary fields are omitted unless org.portalTheme.showSalary is true (see Get a career portal).

Status codes

StatusMeaning
200Success.
404Portal not enabled, or job not found / no longer available.
500Server error.