The Get an Organization API is used to retrieve the complete profile and configuration settings of a specific organization in Zoho Books. Unlike the "List Organizations" endpoint, this provides granular data, including address details and specific regional settings.
Method: GET
URL: https://www.zohoapis.com/books/v3/organizations/{organization_id}
Note on Domains: Depending on your data center, the base URL may vary (e.g., .eu, .in, .com.au).
To access this endpoint, you must include a valid OAuth 2.0 access token in the header.
Header: Authorization: Zoho-oauthtoken <YOUR_ACCESS_TOKEN>
Required Scope: ZohoBooks.organizations.READ
| Parameter | Type | Description |
organization_id | String | The unique identifier of the organization you wish to fetch. |
A successful request (HTTP 200) returns an organization object:
{
"code": 0,
"message": "success",
"organization": {
"organization_id": "10234695",
"name": "Kalki LLP - Tech Solutions",
"contact_name": "Admin User",
"email": "admin@kalkillp.com",
"is_active": true,
"currency_id": "460000000000097",
"currency_code": "USD",
"currency_symbol": "$",
"currency_format": "1,234,567.89",
"price_precision": 2,
"time_zone": "America/New_York",
"date_format": "yyyy-MM-dd",
"field_separator": "comma",
"fiscal_year_start_month": 1,
"address": "123 Tech Park",
"city": "Austin",
"state": "Texas",
"zip": "73301",
"country": "USA",
"phone": "123-456-7890",
"website": "www.kalkillp.com"
}
}
If you are working within the Zoho ecosystem (Creator, CRM, or Books Custom Functions), use the following script:
// Replace with your actual Organization ID
orgID = "10234695";
response = invokeurl
[
url :"https://www.zohoapis.com/books/v3/organizations/" + orgID
type :GET
connection:"zoho_books_connection" // Ensure this connection has organizations.READ scope
];
if(response.get("code") == 0)
{
orgDetails = response.get("organization");
info "Organization Name: " + orgDetails.get("name");
info "Base Currency: " + orgDetails.get("currency_code");
}
else
{
info "Error fetching data: " + response.get("message");
}
| Code | Message | Resolution |
| 57 | Invalid organization_id | The ID in the URL is incorrect or does not exist in your account. |
| 6024 | User belongs to multiple organizations... | You must explicitly pass the organization_id as a path parameter (which this endpoint requires). |
| 401 | Unauthorized | The access token is expired or the scope ZohoBooks.organizations.READ was not granted during OAuth. |
| 429 | Rate Limit Exceeded | Zoho Books limits API calls to 100 requests per minute. Implement a retry-after logic. |