> ## Documentation Index
> Fetch the complete documentation index at: https://clumio.reclear.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Make your first API request

> Create a token, choose a regional endpoint, and make a read-only request.

This quickstart sends a read-only request to list users. It shows the minimum request shape before
you move to task-specific API guides.

<Note>
  **Prototype note.** This request is an illustrative example and has not been validated against a
  live tenant. Confirm the endpoint version and response shape in the canonical endpoint reference
  before shipping an integration.
</Note>

## 1. Set credentials

Create a token in [Access management](/developer-tools/authentication), then export it locally:

```bash theme={null}
export CLUMIO_API_TOKEN="<your_api_token>"
export CLUMIO_API_BASE_URL="https://us-west-2.api.clumio.com"
```

Use the base URL for the control plane that issued the token. See [regional API base
URLs](/api-reference/regions).

## 2. Send the request

```bash theme={null}
curl "${CLUMIO_API_BASE_URL}/users?limit=10&start=1" \
  -H "Accept: application/api.clumio.users=v2+json" \
  -H "Authorization: Bearer ${CLUMIO_API_TOKEN}"
```

The response is a paginated HAL document. Inspect `_embedded.items` for users and `_links.next` for
the next page.

## 3. Choose the next guide

* [Discover resources](/api-reference/discovery)
* [Start a restore](/api-reference/start-restore)
* [Monitor a task](/api-reference/monitor-task)
* [Full API reference](https://api.commvault.com/docs/latest/api/cv/ClumioAPIs/clumio-rest-api/)