---
title: "Quickstart: your first API call"
url: https://docs.corefinity.com/start/quickstart-first-api-call
type: page
last_updated: 2026-11-13
feature: start
---
# Quickstart: your first API call

Create a read-only API token, call GET /api/user and list your sites.

## Before you start

- You can sign in to the Control Panel.
- Your account has two-factor authentication on, if your organisation requires it.

1. **Create a token**

   In the Control Panel, open the menu under your name, choose **Profile**, then **API tokens**. Create a token with only **Read** ticked and **7 days** under **Expires**, then copy it: see [API tokens](/guides/your-account/api-tokens).

   _Screenshot: The Copy your token now dialog showing the token once, with the button I've stored it._

   ```bash
   export COREFINITY_TOKEN='YOUR_TOKEN'
   ```

2. **Check who you are**

   ```bash
   curl https://manage.corefinity.com/api/user \
     -H "Authorization: Bearer $COREFINITY_TOKEN" \
     -H "Accept: application/json"
   ```

   ```json
   {
     "user": {
       "id": "1042",
       "company_id": "77",
       "name": "Alex Example",
       "email": "alex@example.com"
     }
   }
   ```

3. **List your sites**

   ```bash
   curl "https://manage.corefinity.com/api/corestack/sites?limit=20" \
     -H "Authorization: Bearer $COREFINITY_TOKEN" \
     -H "Accept: application/json"
   ```

   The answer holds `sites`, one entry per site with its `kind`, `platform` and `environments`, and `next_cursor` for the next page.

## Next

- [Authentication](/api/authentication): Send the token with a request.
- [Scopes](/api/scopes): See what each scope allows.
- [Errors and refusals](/api/errors): Read a refusal and act on it.
