Skip to main content
Customer Recommendations

Authentication Required

This endpoint requires API key authentication via Bearer token in the Authorization header.

Path Parameters

string (UUID)
required
Unique identifier for the customer to get recommendations for

Query Parameters

boolean
Whether to include segment-based recommendations in the response. Defaults to false.
string
Filter recommendations by region (e.g., “BH” for Bahrain). Comma-separated values for multiple regions.

Response

The API returns a JSON array of recommendation objects:

Error Codes

Example

Best Practices

  1. Caching: Cache recommendations for frequently requested customers to improve performance
  2. Error Handling: Implement proper error handling for cases where no recommendations are available
  3. Rate Limiting: Be mindful of API rate limits (1000 requests per minute)
  4. Validation: Validate the customer_id format before making the request
Need help? Contact our support team at [email protected]