Guru API Overview

Authentication

The API uses Basic Authentication. To access the API, you need to obtain your API credentials by following the instructions in our Help Center article.

There are two types of authentication tokens:

Collection Token (Read-only)
User Token (Read/Write)

For detailed information, consult our User and Collection token guide.

API Structure

Guru's API follows the REST protocol, using JSON as the data format. The root URL for all endpoints is https://api.getguru.com/api/v1/.

Testing Your Credentials

To test your authentication credentials:

With a User Token:

curl -u USER:TOKEN https://api.getguru.com/api/v1/teams -D -

With a Collection Token (ensure you have the necessary Collection ID):
```
curl -u COLLECTION_ID:TOKEN https://api.getguru.com/api/v1/teams -D -
```

Upon successful authentication, you should receive a JSON response with your Guru team information:

[
  {
    "status": "ACTIVE",
    "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "dateCreated": "2025-01-01T00:00:00.000+0000",
    "name": "My Guru Team"
  }
]

Explore more in our comprehensive API documentation!