API Usage & Pricing Guide
Subscription-Based Pricing Overview
How Our Pricing Works
Barikoi offers subscription-based pricing with flexible plans to match your specific needs. Each plan includes:
- Daily API call limits - Use these calls across any of our APIs
- Request limits - Maximum locations and vehicles based on your plan
- Monthly billing - Simple payment cycle with clear usage metrics
Need a custom solution? If our standard plans don't match your requirements, contact us directly to discuss a tailored plan for your business needs.
Understanding API Calls vs Requests
A single API request doesn't always equal a single API call:
- Some API endpoints call multiple internal APIs to deliver comprehensive results
- The number of calls depends on the parameters included in your request
- Complex operations (like Rupantor API or Routing API) consume multiple calls per request
Example: A request to Rupantor API results in 2 API calls because it internally uses geocode API to operate.
API Call Count Reference
Below is a detailed breakdown of how many API calls are consumed by each request type and parameter:
Reverse Geocode API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | Address | 1 |
| District | 1 | Union | 1 |
| Post_code | 1 | Pouroshova | 1 |
| Country | 1 | Location_type | 1 |
| Sub_district | 1 | Division | 1 |
| Area | 1 | Post_office | 0 |
| Thana | 0 | Bangla | 0 |
| Match | 0 | | |
Reverse Geocoding API (server)
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | Address | 1 |
| District | 1 | Union | 1 |
| Post_code | 1 | Pouroshova | 1 |
| Country | 1 | Location_type | 1 |
| Sub_district | 1 | Division | 1 |
| Area | 1 | Post_office | 0 |
| Thana | 0 | Bangla | 0 |
| Match | 0 | | |
Geocoding API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Autocomplete API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Autocomplete API with city filter
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Post Office autocomplete API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | Post_office | 1 |
| All Other Parameters | 0 | | |
Industrial autocomplete API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Bangla autocomplete API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | Bangla | 1 |
| All Other Parameters | 0 | | |
Distance API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Rupantor geocoder API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 2 | District | 1 |
| Thana | 1 | Bangla | 1 |
| All Other Parameters | 0 | | |
Routing API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 2 | All Other Parameters | 0 |
Route optimization API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 1 | All Other Parameters | 0 |
Nearest API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 2 | All Other Parameters | 0 |
Route Match API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 2 | All Other Parameters | 0 |
Map API
| Parameter | Call Count | Parameter | Call Count |
|---|
| Base Count | 4 | All Other Parameters | 0 |
Custom API: 50 paisa per API call.
Exceeding Call Limits
What happens when you exceed your call limit?
If you go over your daily/monthly call limit:
- Your API key will continue to work initially
- You'll receive an email notification
- For frequent overages, we'll contact you to discuss adjusting your plan
- Significant overuse may trigger a hard limit to protect our platform
Note: There is also a permissive per-minute call limit. If exceeded, you'll receive a 429 error (Too Many Requests). Consider delaying requests or upgrading your plan if this occurs regularly.
Billing Cycle
Your default billing cycle starts from the day your API key is generated and continues for 29 days. This cycle can be adjusted according to your convenience.