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

# Introduction

> This is the public API documentation for FirstPromoter V2.

Welcome to the FirstPromoter API! This documentation will guide you through the process of integrating with our platform programmatically, allowing you to leverage the full power of FirstPromoter's affiliate and referral tracking capabilities in your own applications.

### Why Use Our API?

**Automation:** Streamline your workflow by automating repetitive tasks\
**Integration:** Seamlessly incorporate FirstPromoter's capabilities into your existing systems **Customization:** Build custom solutions tailored to your specific business needs

### Who Should Use This API?

Due to the technical nature of API integrations, this documentation is designed for developers and any other technical  individual who  want to:

* Integrate FirstPromoter with their existing tools and platforms
* Create custom dashboards or reporting systems
* Automate affiliate management processes
* Build specialized applications leveraging FirstPromoter's functionality

### Getting Started

To begin using the FirstPromoter API, you'll need:

1. A FirstPromoter account
2. Your account id and an API key
3. Basic knowledge of REST API principles

### Rate Limits

To ensure fair usage and system stability, FirstPromoter implements the following rate limits:

* 400 requests per minute per account

Exceeding these limits will result in a `429 Too Many Requests` response.

### Pagination

When retrieving multiple affiliates, the API uses pagination to limit the number of records returned in a single response. This ensures optimal performance for both the API and your application.

### Pagination Parameters

| Parameter  | Type    | Description                                        |
| ---------- | ------- | -------------------------------------------------- |
| `page`     | Integer | The page number to retrieve (default: 1)           |
| `per_page` | Integer | Number of records per page (default: 20, max: 100) |