Account360 Search
Use the Account360 Search endpoint to discover and filter accounts based on firmographic criteria, engagement signals, and intent data. This endpoint combines the power of Sona's search filtering with the rich account intelligence provided by Account360 — returning paginated results with account detail for each match.
Account360 Search is ideal for building targeted account lists, identifying high-intent accounts at scale, or powering account-based marketing workflows. Instead of querying accounts one domain at a time, you can search across your entire account universe using flexible filter combinations.
Calling this endpoint consumes credits under your Sona pricing plan.
Request
Headers
| Header | Value | Required |
|---|---|---|
x-api-key | Your API key | Yes |
Content-Type | application/json | Yes |
Accept | application/json | Yes |
Body
The request body accepts a JSON object with a filters array. Each filter object contains three attributes: field, operator, and value.
| Parameter | Type | Required | Description |
|---|---|---|---|
filters | array | Yes | An array of filter objects to narrow down results. |
Filter object
| Attribute | Type | Required | Description |
|---|---|---|---|
field | string | Yes | The account field to filter on. |
operator | string | Yes | The comparison operator. |
value | string | No | The value to filter by. Not required for is empty and is not empty operators. |
Supported fields
name, domain, industry, subIndustry, country, city, state, postalCode, streetAddress, type, phone, employees, employeesRange, annualRevenue, estimatedAnnualRevenue, foundedYear, linkedin, tech, techCategories, tags, buyingStage, lifecycleStage, icpScore, visitorsCount, identifiedPeople, intentSignals, sessionsDuration, totalActiveTime
Supported operators
is not empty, contains, =, >, <, >=, <=, <>, range, in set (exact), in set (phrase), starts with, does not contain, is empty
Example request
curl --request POST \
--url "https://api2.sonalabs.com/resource/account360/search" \
--header "x-api-key: your-api-key-here" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data '{
"filters": [
{
"field": "industry",
"operator": "contains",
"value": "Technology"
},
{
"field": "icpScore",
"operator": ">=",
"value": "70"
},
{
"field": "buyingStage",
"operator": "=",
"value": "Purchase"
}
]
}'
Responses
200 — Success
Returns a paginated list of accounts matching your filter criteria. Each account includes account intelligence data including firmographic details, engagement signals, and technology stack.
{
"version": "2.0.0",
"status": "success",
"data": {
"list": [
{
"details": {
"name": "Cimpress",
"description": "Cimpress is a world leader in mass customization, investing in and building customer-focused entrepreneurial businesses for personalized products.",
"domain": "cimpress.com",
"type": "public",
"phone": "+1 781-652-6300",
"uuid": "4bf72c29-307a-436d-8054-4e6f210af19d",
"createdAt": "2025-08-16T02:51:09",
"employees": 16000,
"employeesRange": "10K-50K",
"visitorsCount": 9,
"identifiedPeople": 0,
"annualRevenue": 3079627000,
"estimatedAnnualRevenue": "$1B-$10B",
"foundedYear": 1995,
"streetAddress": "",
"city": "Dundalk",
"postalCode": "A91 X3N0",
"state": "County Louth",
"country": "Ireland",
"industry": "Commercial Services & Supplies",
"subIndustry": null,
"linkedin": "company/cimpress"
},
"intentSignals": [
"Visit Greater than 30s",
"Visit Greater than 120s",
"Visited Website",
"Read any blog post",
"Requested Google Ads Guide"
],
"intentTrends": [],
"sessionsDuration": 157,
"totalActiveTime": 39,
"buyingStage": "Decision",
"lifecycleStage": "lead",
"icpScore": 0,
"tags": [
"Printing",
"Manufacturing",
"E-commerce",
"Technology",
"Marketing",
"B2B",
"Enterprise"
],
"tech": [
"amazon_ses",
"google_apps",
"mailchimp",
"nginx",
"recaptcha",
"wordpress",
"zendesk",
"google_tag_manager",
"salesforce",
"snowflake"
],
"techCategories": [
"email_delivery_service",
"productivity",
"web_servers",
"content_management_system",
"customer_support",
"tag_management",
"crm",
"cloud_computing_services"
]
}
],
"total": 131,
"offset": 0,
"limit": 25
}
}
Key data returned per account
- Account details — name, description, domain, type, phone, UUID, employees, employee range, annual revenue, estimated revenue range, founded year
- Location — street address, city, postal code, state, country
- Industry — industry classification and sub-industry
- Intent — intent signals and intent trends
- Scoring — buying stage, lifecycle stage, ICP score
- Sessions — sessions duration, total active time
- Technology — tech stack and tech categories
- Tags — account-level tags and classifications
Pagination
| Field | Type | Description |
|---|---|---|
total | integer | Total number of matching accounts |
offset | integer | Current offset in the result set |
limit | integer | Maximum number of results returned per request |
400 — Error
Returned when the request body is missing or contains no filters.
{
"version": "2.0.0",
"status": "error",
"data": {
"message": "Please provide at least one filter."
}
}
404 — Error
Returned when no accounts match the provided filters.
{
"version": "2.0.0",
"status": "error",
"data": {
"message": "No results found"
}
}