> For the complete documentation index, see [llms.txt](https://docs.cloutly.com/reviews-sdk-for-marketplace-websites/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloutly.com/reviews-sdk-for-marketplace-websites/rest-api/swagger-specs.md).

# REST API Basics

## Base API domain

```
https://app.cloutly.com/api/v1
```

## Authentication

Add `x-api-key` to every request:

```
x-api-key: YOUR_API_KEY_HERE
```

## Rate limiting

Default limit is `200 requests/minute`.\
If rate-limited, the API returns `429 Too Many Requests`.

## Error responses

* `400 Bad Request` - invalid request shape or values.
* `401 Unauthorized` - missing/invalid API key.
* `404 Not Found` - resource does not exist.
* `429 Too Many Requests` - request quota exceeded.

## Core endpoints

* `GET /businesses`
* `GET /reviews`
* `PUT /reply`
* `POST /send-review-invite`