Public API Endpoints
Getting started with the OZZOBiT Public API
The OZZOBiT Public API provides read-only endpoints for fetching reference data including supported countries, currencies, payment methods, exchange quotes, and order information. These endpoints use your public API key for authentication.
Base URL
texttext
// Production
https://OZZOBiT.com/api/api/v2
// Staging/Sandbox
https://staging-OZZOBiT.com/api/api/v2Authentication
Include your public API key as a query parameter:
texttext
GET /api/v2/countries?apiKey=YOUR_PUBLIC_API_KEYPublic vs Secret Key
The Public API uses your public API key (safe for client-side code). The Whitelabel API requires your secret key and access tokens (server-side only).
Available Endpoints
| Endpoint | Method | Description |
|---|---|---|
| /orders | GET | List all orders for your partner account |
| /orders/:id | GET | Get details of a specific order |
| /crypto-currencies | GET | List all supported cryptocurrencies |
| /fiat-currencies | GET | List all supported fiat currencies |
| /countries | GET | List all supported countries with features |
| /payment-methods | GET | List available payment methods by country |
| /lookup/quote | POST | Get real-time exchange rate quote |
| /wallet/verify | POST | Verify a wallet address format |
Error Responses
All endpoints follow a consistent error format:
error-response.jsonjson
{
"error": {
"code": "INVALID_API_KEY",
"message": "The provided API key is invalid or expired",
"status": 401
}
}| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Invalid or missing parameters |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Access denied - IP not whitelisted |
| 404 | NOT_FOUND | Resource not found |
| 429 | RATE_LIMITED | Too many requests - slow down |
| 500 | INTERNAL_ERROR | Server error - try again later |