Introduction

The Zoho Invoice API allows you to perform all the operations that you do with our web client.

Zoho Invoice is available in 3 domains. Click on the corresponding domain to access its API Guide:

Zoho Invoice API is built using REST principles which ensures predictable URLs that makes writing applications easy. This API follows HTTP rules, enabling a wide range of HTTP clients which can be used to interact with the API.

Every resource is exposed as a URL. The URL of each resource can be obtained by accessing the API Root Endpoint.

The Organization ID and the Access token has to be sent as Header in the API.The JSON String has to be sent as form-data.

Server to server calls are only possible.


https://invoice.zoho.com/api/v3

Organization ID

In Zoho Invoice, 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 Invoice Organization with it’s 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. Alternatively, it can be obtained from the Manage Organizations page in the admin console:

Login to the Zoho Invoice admin console. Click the drop down with organization’s name as the label and click Manage Organizations.


$ curl https://invoice.zoho.com/api/v3/organizations


{
  "code": 0,
  "message": "success",
  "organizations": [
    {
      "organization_id": "10234695",
      "name": "Zillum",
      "contact_name": "John Smith",
      "email": "johnsmith@zillum.com",
      "is_default_org": false,
      "language_code": "en",
      "fiscal_year_start_month": 0,
      "account_created_date": "2016-02-18",
      "time_zone": "PST",
      "is_org_active": true,
      "currency_id": "460000000000097",
      "currency_code": "USD",
      "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. The limits on total calls are illustrated below:

Paid Organization - 2500 API calls/day and 100 API calls/minute
Free Organization - 1000 API calls/day and 100 API calls/minute