Home
Loyalty API

Rate Limits

How many Loyalty API requests you can make per minute, and what happens when you make more.

Loyalty API requests are rate limited to protect against spikes in traffic and keep the platform stable. Endpoints are grouped into categories, and each category has its own limit:

CategoryLimit
Write APIs50 requests per minute
Member eligibility APIs50 requests per minute
General APIs100 requests per minute

When a limit is exceeded, the API responds with 429 Too Many Requests and the following body. Retry the request using exponential backoff.

{
  "reason": "Rate limit exceeded",
  "error_code": "RATE_LIMIT_EXCEEDED",
  "success": false
}

These limits apply to the standard plan. To find out the limits of your plan, contact your account manager at support@trueloyal.com. If you expect a surge in requests, for example because of a promotion or a special campaign, let your account manager know in advance.

Write APIs

  • Create a loyalty member
  • Update a loyalty member with member ID
  • Update a loyalty member with TrueLoyal-generated ID
  • Award points
  • Redeem points
  • Deduct points
  • Return points
  • Approve a pending award/redeem transaction using ID
  • Approve a pending award/redeem transaction using unique transaction attribute
  • Reject a pending award/redeem transaction using ID
  • Reject a pending award/redeem transaction using unique transaction attribute
  • Modify a pending award transaction with transaction ID
  • Modify a pending award transaction using unique transaction attribute
  • Reverse points with transaction ID
  • Reverse points using unique transaction attribute

Member eligibility APIs

  • List all the eligible activities for a member using TrueLoyal-generated member ID
  • List all the eligible activities for a member using member ID
  • Get eligible rewards with member ID
  • Get eligible rewards with TrueLoyal-generated member ID

General APIs

  • Retrieve a loyalty member with member ID
  • Retrieve a loyalty member with TrueLoyal-generated ID
  • List members
  • Delete a loyalty member with member ID
  • Delete a loyalty member with TrueLoyal-generated ID
  • List all activities
  • Retrieve an activity using activity ID
  • Retrieve an activity using TrueLoyal-generated ID
  • Retrieve custom attributes for an activity using activity ID
  • Retrieve custom attributes for an activity using TrueLoyal-generated ID
  • List all rewards
  • Retrieve a transaction with transaction ID
  • Retrieve a transaction using unique transaction attribute
  • List all transactions
  • List all transactions with member ID
  • List all transactions with TrueLoyal-generated member ID
  • List all tiers
Docs by Sourcey