Skip to main content
The Partnero REST API lets you programmatically manage your affiliate and referral programs. Use it to create partners, track customers, record transactions, and automate your partner operations.

​
Base URL

All API requests should use the following base URL: 
https://api.partnero.com/v1/

​
Authentication

All API requests require authentication using a Bearer token in the Authorization header: 
Authorization: Bearer YOUR_API_KEY
See Authentication for details on obtaining and using API keys.

​
Response Format

All responses are returned in JSON format with a status field indicating success (1) or failure. 
{
  "data": { ... },
  "status": 1
}

​
HTTP Status Codes

Partnero returns standard HTTP response codes:
CodeNameDescription
200OKRequest was successful
201CreatedResource was created successfully
400Bad RequestInvalid request parameters
401UnauthorizedInvalid or missing API token
403ForbiddenAction not allowed for this token
404Not FoundResource does not exist
422Unprocessable EntityValidation error
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error

​
Rate Limiting

API requests are rate-limited to ensure fair usage. If you exceed the rate limit, you’ll receive a 429 Too Many Requests response.

​
Pagination

List endpoints support pagination with the following query parameters:
ParameterTypeDefaultDescription
limitinteger15Number of results per page (1-250)
pageinteger1Page number
Paginated responses include links and meta objects: 
{
  "data": [...],
  "links": {
    "first": "https://api.partnero.com/v1/partners?page=1",
    "last": null,
    "prev": null,
    "next": "https://api.partnero.com/v1/partners?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "path": "https://api.partnero.com/v1/partners",
    "per_page": 15,
    "to": 15
  },
  "status": 1
}

​
Quick Start

1

Get your API key

  1. Go to your program in Partnero
  2. Navigate to Integration → API
  3. Click Create API key
  4. Copy the generated key (you won’t be able to see it again)
2

Make your first request

Test your connection by listing partners:
curl --location 'https://api.partnero.com/v1/partners' \
  --header 'Authorization: Bearer YOUR_API_KEY'
3

Explore the API

Browse the sidebar to explore all available endpoints.

​
Error Handling

Error responses include a message explaining what went wrong: 
{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required."]
  },
  "status": 0
}

​
Need Help?

JavaScript SDK

Client-side tracking integration

Webhooks

Real-time event notifications

​
Frequently Asked Questions

Partners are affiliates who promote your product and earn commissions. Customers are end-users who sign up through partner referral links. Partners bring in customers, and you pay partners commissions on customer purchases.
Partially. Payment integrations (Stripe, Paddle, Shopify) automatically track transactions, but you still need to create customers using the API or JavaScript SDK. The customer links sign-ups to the referring partner, and the integration handles sales tracking from there.
Use your API key from the Partnero dashboard. All endpoints work the same in test and production—there’s no separate sandbox environment. We recommend creating a test program for development.