RErecruitwithatlas
Jobs Portal

Get public project details

Changed on

Use this endpoint to retrieve details of a public project without authentication.

This endpoint is limited to projects where public is true. It is intended for use in public-facing integrations such as career pages or job boards.

The response includes the owner — the lead consultant on the role, as { name, email } — so you can display a contact on the job page. owner.email is null unless your agency has opted in to publishing project owners' emails. owner is null when the project has no owner, or when the recorded owner does not belong to the project's agency.

Compared to the authenticated Get project details endpoint, this response does not include company, endClient, members, or stages.

What you need to provide:

  • The agency ID in the URL path - the agency the project belongs to
  • The project ID in the URL path - the project you want to retrieve

Both IDs are UUIDs. If the project does not exist, does not belong to the specified agency, or is not marked as public, a 404 response is returned.

get/api/v1/public/{agencyId}/projects/{id}

Request

Path parameters

agencyIdstring uuid required

Agency ID

Example:550e8400-e29b-41d4-a716-446655440000
idstring uuid required

Project ID

Example:550e8400-e29b-41d4-a716-446655440001

Response

Public project details

status'ok' required

Example response

{
  "data": {
    "jobRole": "Software Engineer",
    "state": "active",
    "hireTarget": 1,
    "salaryCurrency": "USD",
    "location": {
      "city": "London",
      "region": "England",
      "country": "United Kingdom",
      "formattedAddress": "London, England, United Kingdom"
    },
    "startedAt": "2026-03-23",
    "owner": {
      "name": "Jane Smith",
      "email": "owner@agency.com"
    },
    "updatedAt": "2026-06-04T10:00:00.000Z"
  }
}

Changes

  • 158ee454751cRevision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      removed the required property // from the response with the status

    • warning

      added the new undefined enum value to the / response property for the response status

    • warning

      added the new undefined enum value to the /// response property for the response status

    • warning

      added the new undefined enum value to the / response property for the response status

    • warning

      added the new undefined enum value to the / response property for the response status

  • cd4bc8bbd95eRevision changes
    • info

      added the optional property to the response with the status