> ## Documentation Index
> Fetch the complete documentation index at: https://hireflixsl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# How-to: Fetching Positions
## 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](/quickstart) 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.
* **archivedAtISO** – 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
```json theme={null}
{
"data": {
"positions": [
{
"id": "63d00b73df403de202d97e73",
"name": "Sales Manager",
"tags": ["US"],
"archivedAtISO": null
},
{
"id": "63d00b73df403de202d97e74",
"name": "Sales Manager",
"tags": ["UK"],
"archivedAtISO": 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)”.
Let's learn how to update a position.