# Quickstart

> Authenticate, find your tasks, and inspect a report. Start with read-only requests.

Source: https://math-api.qmindlabs.ai/docs/quickstart

## 1\. Get an API key

Ask your Math workspace administrator for a key with `read`. Add `files:read` to download reports and `paths:read` if you need storage locations. Store it in your secret manager or a private `MATH_API_KEY` environment variable.

## 2\. Verify your access

```sh
curl --fail-with-body 'https://math-api.qmindlabs.ai/api/auth/session' \
  -H "Authorization: Bearer $MATH_API_KEY"
```

The response includes your effective role and scopes. A reviewer sees assigned tasks; an owner or administrator has broader Math access.

## 3\. Find your tasks

```sh
curl --fail-with-body 'https://math-api.qmindlabs.ai/api/math/tasks?page=1&page_size=25' \
  -H "Authorization: Bearer $MATH_API_KEY"
```

Use each task’s `id` from `tasks[]` as the `task_id` path parameter. Filter by `question_id`, `review_state`, `reviewer_id`, or `q`. The default `surface=all` includes archived tasks.

[GETTask filters and response schema](https://math-api.qmindlabs.ai/docs/api-reference/tag/tasks-review/GET/api/math/tasks.md)

## 4\. Read the workflow

```sh
curl --fail-with-body 'https://math-api.qmindlabs.ai/api/math/tasks/TASK_ID/workflow' \
  -H "Authorization: Bearer $MATH_API_KEY"
```

Replace `TASK_ID` with an ID from your response. This returns the task’s current version, assignment, decision, and history.

## Next steps

[**Make a safe update** Use workflow actions and current versions.](https://math-api.qmindlabs.ai/docs/guides/workflow.md)

[**Get the report** Inspect paths and download permitted files.](https://math-api.qmindlabs.ai/docs/guides/files.md)

**Using the interactive reference**

Select Authentication and enter the token without the Bearer prefix. Keys stay in page memory. Successful write requests change real API data.