Get Customer Tier Status

​

Overview

​

Request

​

Response

​

Response Example

{
  "status": "success",
  "statusCode": 200,
  "message": "Customer tier status retrieved successfully",
  "data": {
    "tierId": 0,
    "hasNin": false,
    "hasBvn": false
  }
}

​

Tier Information

​

Tier Levels

• basic: Standard tier with basic transaction limits
• premium: Enhanced features and higher transaction limits
• enterprise: Custom solutions with maximum limits

​

Status Values

• active: Customer account is active and can transact
• suspended: Customer account is temporarily suspended
• pending: Customer account is under review

​

Example

curl -X GET https://api-staging.fossapay.com/api/v1/customers/fh8e2e1f-e253-23ac-b8ft-31ed2t7fb0df/tier-status \
  -H "x-api-key: YOUR_API_KEY"

const customerId = 'fh8e2e1f-e253-23ac-b8ft-31ed2t7fb0df';
const response = await fetch(`https://api-staging.fossapay.com/api/v1/customers/${customerId}/tier-status`, {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});

const tierStatus = await response.json();
console.log(tierStatus);

​

Rate Limits

• Maximum 100 requests per minute per API key
• Burst limit of 20 requests per second