Skip to main content

​
When to use this

Use this query when you want to display the list of available positions from Hireflix inside your own system. Positions act as interview templates, each containing a set of questions and settings for a role.

​
GraphQL Request

Don’t forget to update the Hireflix API Key in the headers.

​
Explanation

  • id – unique identifier for the position (needed for invites).
  • name – title of the position (e.g. “Sales Manager”).
  • tags – optional labels like location or department, useful to distinguish similar positions.
  • archived – Use this property to filter for active positions. If a position has been closed, the field contains a timestamp of when it was archived. If the value is null, the position is still open.

​
Other helpful fields

  • createdAt - the date the position was created (ISO datetime).
  • question.title - an array of all interview question titles in the position.
  • question.description - an array of all interview question descriptions.

​
Example Response

{
  "data": {
    "positions": [
      {
        "id": "63d00b73df403de202d97e73",
        "name": "Sales Manager",
        "tags": ["US"],
        "archived": null
      },
      {
        "id": "63d00b73df403de202d97e74",
        "name": "Sales Manager",
        "tags": ["UK"],
        "archived": null
      }
    ]
  }
}

​
Tips

  • Filter out archived: Don’t show positions where archived is true.
  • Show tags for clarity: Present “Sales Manager (US)” vs “Sales Manager (UK)”.

Learn next?

Let’s learn how to update a position.