Partner API

The Khaime Partner API lets you create payments, manage subscriptions, and query transaction data from your server.

Base URL

https://api.khaime.com/api/v1/partner

All requests require an API key in the X-API-Key header:

curl -H "X-API-Key: pk_sandbox_your_key_here" \
     https://api.khaime.com/api/v1/partner/products

API keys start with pk_sandbox_ (test) or pk_live_ (production). Generate keys in your Khaime Dashboard.

Limit	Value
Requests per hour	1,000 per API key
Burst	50 requests/second

When rate limited, the API returns 429 Too Many Requests. Rate limits reset hourly.

All responses follow this structure:

Success

{
  "success": true,
  "data": { ... }
}

Error

{
  "success": false,
  "error": "Error message",
  "details": { ... }
}

Code	Meaning
`200`	Success
`201`	Created
`400`	Bad request — check parameters
`401`	Invalid or missing API key
`404`	Resource not found
`422`	Validation error
`429`	Rate limit exceeded
`500`	Server error

List endpoints support pagination via query parameters: