API FAQs

How do I submit array query parameters?

When a query parameter accepts an array, use the [] syntax:

1. Append [] to the parameter name (e.g., ids becomes ids[])
2. Include each array value as a separate parameter

Example:

GET /endpoint?ids[]=1&ids[]=2&ids[]=3&names[]=Alice&names[]=Bob&limit=10

This submits:

• ids as [1, 2, 3]
• names as ["Alice", "Bob"]
• limit as 10

In code (Python):

import requests

params = {
    'ids[]': [1, 2, 3],
    'names[]': ['Alice', 'Bob'],
    'limit': 10
}

response = requests.get(url, headers=headers, params=params)

How do I find my data center region?

Check the URL when you log into Holistics:

URL	Region	API Base URL
secure.holistics.io	Asia-Pacific (APAC)	https://secure.holistics.io/api/v2
eu.holistics.io	Europe (EU)	https://eu.holistics.io/api/v2
us.holistics.io	United States (US)	https://us.holistics.io/api/v2

See Data Centers for more details.

How do I get my API key?

1. Ask your admin to enable API access for your account in User Management
2. Go to User Settings
3. Generate a new API key

See Authentication for detailed steps.

What's the difference between API v1 and v2?

API v2 is the current version with full support. API v1 is legacy and no longer actively maintained.

If you're using API v1, see Migrating V1 to V2 for upgrade guidance.

How do I handle async operations?

Some API operations (like exports) run asynchronously. These endpoints return a job ID that you poll for status:

1. Submit the request → Get job_id
2. Poll GET /jobs/{job_id} until status is success or failure
3. Retrieve the result

See Export Widget Data for a complete example.