Skip to main content
Welcome to the CookieChimp API. We provide a RESTful API that allows you to access all the data on CookieChimp. You can use our API to integrate your applications, services, and workflows with our platform.

​
Base URL

All API requests should be made to: 
https://cookiechimp.com/api/v1

​
Authentication

To authenticate with the CookieChimp API, you need an API token. Include it in the Authorization header of your HTTP requests as a Bearer token: 
Authorization: Bearer YOUR_API_TOKEN

​
Obtaining Your API Token

There are two ways to get an API token:
  1. Via the Dashboard: Go to your API Tokens settings page to create and manage tokens.
  2. Via the API: Use the Login endpoint with your email and password to receive a token.

​
Token Types

API tokens can belong to different bearer types:
  • User tokens — Access resources on behalf of a user across their accounts.
  • Partner tokens — Access partner-level resources like groups.
  • Account tokens — Access resources scoped to a specific account.

​
Rate Limits

To ensure fair usage of the API, we limit the number of requests you can make. The rate limit is 100 requests per minute. If you exceed this limit, you will receive a 429 Too Many Requests response.

​
Pagination

List endpoints support pagination with the following query parameters:
ParameterDescriptionDefault
pagePage number1
per_pageRecords per page (1-50)20
Paginated responses include a pagination object with prev_url, next_url, count, page, prev, and next fields.

​
Errors

The API returns standard HTTP status codes. Error responses include an errors array: 
{
  "errors": [
    {
      "code": 401,
      "message": "Invalid API Key"
    }
  ]
}
Status CodeDescription
200Success
401Unauthorized — invalid or missing API token
404Not found
422Validation error
429Rate limit exceeded