HEheymilo
Interviewers

List interviewer summaries

Changed on

Retrieve a lightweight paginated list of interviewers (id, title, name, status only) for the authenticated workspace. Only active interviewers are returned unless status is given.

get/api/v2/postings/list

Request

  • Base URL
    https://api.heymilo.ai
  • URL
    https://api.heymilo.ai/api/v2/postings/list
  • Auth
    API key in header X-API-KEY

Query parameters

limitinteger
starting_afterstring nullable
searchstring nullable

Case-insensitive substring filter on the posting title.

statusstring[] nullable

Filter by interviewer status. Repeat to combine statuses (?status=expired&status=archived); all returns every status. If omitted, only active interviewers are returned. Pass the same status on every page.

Headers

X-API-KEYstring nullable
Authorizationstring nullable
X-Workspace-Idstring nullable

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "13D77095",
      "title": "Senior Software Engineer",
      "name": "senior-software-engineer",
      "status": "active"
    }
  ]
}

Changes

  • 012c345aec46Revision changes
    • info

      added the new optional query request parameter status

    • info

      added the optional property // to the response with the status