Introduction
The Zoho ERP API allows you to perform all the operations that you do with our web client.
Zoho ERP API is built using REST principles, which ensures predictable URIs and makes writing applications easy. This API follows HTTP rules, so a wide range of HTTP clients can be used to interact with it.
Every resource is exposed as a URI. The URI of each resource can be obtained by accessing the API root endpoint.
https://www.zohoapis.in/erp/v3
Organization ID
In Zoho ERP, your business is termed as an organization. If you have multiple businesses, you simply set each of those up as an individual organization. Each organization is an independent Zoho ERP organization with its own organization ID, base currency, time zone, language, contacts, reports, etc.
The parameter organization_id along with the organization ID should be sent in with every API request to identify the organization.
The organization_id can be obtained from the GET /organizations API’s JSON response.
oauthscope : ERP.settings.READ
Alternatively, it can be obtained from the Manage Organizations page in the admin console:
Log in to the Zoho ERP admin console. Click the dropdown with organization’s name as the label and click Manage Organizations.
$ curl -X GET 'https://www.zohoapis.in/erp/v3/organizations' \
-H 'Authorization: Zoho-oauthtoken 6e80xxxxxxxxxxxxxxxxxxxxxxxx8a80'
{
"code": 0,
"message": "success",
"organizations": [
{
"organization_id": "10234695",
"name": "Zylker Inc",
"contact_name": "John Smith",
"email": "johnsmith@zylker.org",
"is_default_org": false,
"language_code": "en",
"fiscal_year_start_month": 0,
"account_created_date": "2016-02-18",
"time_zone": "Asia/Kolkata",
"is_org_active": true,
"currency_id": "460000000000097",
"currency_code": "INR",
"currency_symbol": "₹",
"currency_format": "###,##0.00",
"price_precision": 2
},
{...},
{...}
]
}
API Call Limit
API calls are limited to provide better quality of service and availability to all the users. You can make 100 requests per minute per organization. Zoho ERP (India) offers Standard and Premium plans only. The limits on total requests per day are listed below for each plan:
- Standard plan — 2,000 requests/day
- Premium plan — 10,000 requests/day
An error with HTTP status code 429 will be returned if the number of requests made exceeds the number of requests of a particular plan.
{
"code": 45,
"message": "The API call for this organization has exceeded the maximum call rate limit of 1000."
}
An error with HTTP status code 429 will be returned if the number of requests per minute per organization exceeds 100. Users who access the application via the web interface may encounter the following error.
{
"code": 44,
"message": "For security reasons your account has been blocked as you have exceeded the maximum number of requests per minute that can originate from one account."
}
An error with HTTP status code 429 will be returned if the number of requests per minute per organization exceeds 100. API customers may encounter the following error.
{
"code": 44,
"message": "For security reasons your organization has been blocked as it have exceeded the maximum number of requests per minute that can originate from an organization."
}
Concurrent Rate Limiter
The concurrent rate limiter is the maximum number of API calls that can be simultaneously active for an organization at any given point in time.
The concurrent rate limit varies based on the plan:
- Trial plans — 5 concurrent calls (soft limit)
- All plans — 10 concurrent calls (soft limit)
An error with HTTP status code 429 will be returned if the number of concurrent calls exceeds the specified limits.
{
"code": 1070,
"message": "You have reached the maximum number of in process requests allowed. Kindly try again after some time."
}