Skip to main content
Welcome to the Blaaiz Platform API reference documentation. This section provides detailed information about all available API endpoints, request/response formats, and integration examples.

​
Base URL

Production: 
https://api-prod.blaaiz.com
Sandbox: 
https://api-dev.blaaiz.com

​
Authentication

All external API requests require a Bearer access token.
  1. Generate your OAuth credentials from API & Webhooks in the Blaaiz dashboard.
  2. Exchange them at POST /oauth/token using grant_type=client_credentials and the scopes assigned to your credentials.
  3. Include the returned token in your request headers:
Authorization: Bearer YOUR_ACCESS_TOKEN
OAuth credentials are generated from the API & Webhooks page in the Blaaiz dashboard after API Services have been enabled for your account. Development and production use different credentials. Legacy API key creation is disabled, and legacy API key support will end soon. New integrations should use OAuth only. See Getting Started and Authentication for the full access steps.

​
Available endpoints

The Blaaiz RaaS API provides the following endpoint categories:
  • Virtual Bank Account - Create and manage virtual bank accounts for collections
  • Bank - Retrieve bank information and perform account lookups
  • Payout - Initiate payouts to customers
  • Fees - Get fee breakdowns for transactions
  • Currency - Retrieve supported currencies
  • Wallet - Manage your business wallets
  • Collection - Initiate and manage collections
  • Swap - Swap funds between your business wallets
  • File - Upload customer documents
  • Transaction - List and retrieve transaction details
  • Customer - Create and manage customers and their KYC data
  • Webhook - Configure and manage webhook URLs

​
Response format

All API responses are returned in JSON format. Successful responses will include the requested data, while error responses will include a message key with details about the error.

​
Rate limits

External API endpoints are rate limited to 120 requests per minute and 1,500 requests per hour. See Rate and usage limits for more details.