Introduction

The Icodrip REST API lets you manage your affiliate program programmatically. All endpoints return JSON and require authentication via API key.

Base URL

All API requests are made to the following base URL:

https://api.icodrip.com/v1

Response Format

All responses return JSON. List endpoints support pagination via ?page=1&limit=25 query parameters. The response envelope always includes a data field and a meta field with pagination info.

{
  "data": { ... },
  "meta": { "page": 1, "limit": 25, "total": 42 }
}

Error Handling

When a request fails, the API returns an appropriate HTTP status code along with a JSON body containing an error object. The code field is a machine-readable identifier and message is a human-readable description.

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

Example Request

Here is an example request that retrieves your affiliate programs using curl:

curl -X GET https://api.icodrip.com/v1/programs \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

A successful response returns the list of programs:

{
  "data": [
    {
      "id": "prog_01HXYZ...",
      "name": "Main Program",
      "commission_type": "percentage",
      "commission_value": 2000,
      "currency": "USD",
      "cookie_window_days": 90,
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 25, "total": 1 }
}