API v1.0

IQTravel API Documentation

Build powerful mobile apps with our comprehensive REST API. Manage eSIMs, orders, customers, and more with simple HTTP requests.

Contact Support
Fast & Reliable
Lightning-fast response times with 99.9% uptime SLA. Built on Next.js and Supabase for maximum performance.
Secure by Default
JWT-based authentication, row-level security, and encrypted data transmission. Your data is always protected.
Global Coverage
Access coverage data for 190+ countries and territories. Real-time eSIM management and activation.
Quick Start Guide
Get up and running with the IQTravel API in minutes

Base URL

https://iqtravel.app/api/mobile/v1

Authentication

Most endpoints require authentication. Include your access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Example Request

curl -X GET \
  'https://iqtravel.app/api/mobile/v1/bundles' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response Format

All API responses follow a consistent structure:

{
  "success": true,
  "data": { ... },
  "error": null,
  "timestamp": "2024-01-02T19:00:00Z"
}

Paginated responses include pagination info within the data object:

{
  "success": true,
  "data": {
    "items": [...],
    "total": 100,
    "page": 1,
    "pageSize": 20
  },
  "error": null,
  "timestamp": "2024-01-02T19:00:00Z"
}

Error Responses

When an error occurs, the response includes an error object with code and message:

{
  "success": false,
  "data": null,
  "error": {
    "code": "AUTH_INVALID",
    "message": "Invalid or expired token"
  },
  "timestamp": "2024-01-02T19:00:00Z"
}

Common error codes: AUTH_REQUIRED, AUTH_INVALID, VALIDATION_ERROR, NOT_FOUND, SERVER_ERROR

Rate Limiting

API requests are limited to 100 requests per minute per user. Rate limit information is included in response headers.

Need Help?

Our developer support team is here to help you integrate successfully.

Contact SupportHelp Center