Skip to main content
POST
/
v2
/
inbound
/
accounts
/
search
Search accounts
curl --request POST \
  --url https://enrich.octolane.com/v2/inbound/accounts/search \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "query": "<string>",
  "filters": [
    {}
  ],
  "sort": {},
  "cursor": "<string>",
  "limit": 123,
  "fields": [
    "<string>"
  ]
}
'
Advanced search endpoint for Accounts. Supports filters on system and custom fields, sorting, cursor pagination, and field selection.

​
Request

​
X-API-Key
string
required
Your Octolane API key.
​
Content-Type
string
required
Must be application/json.

​
Body parameters

​
query
string
Basic text search across account name and domain. Alias: q.
​
filters
array
Array of filter objects. See Filters for operators and aliases.
​
sort
string | object | array
Sort configuration. See Sorting below.
​
cursor
string
Opaque cursor from a previous response. See Cursor pagination.
​
limit
number
default:"100"
Page size. Max 500.
​
fields
string[]
Fields to return. If omitted, all common fields are returned.

​
Example request

curl -X POST "https://enrich.octolane.com/v2/inbound/accounts/search" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "acme",
    "filters": [
      {
        "field": "customer_tier",
        "operator": "eq",
        "value": "enterprise"
      }
    ],
    "sort": { "field": "updated_at", "direction": "desc" },
    "limit": 10,
    "fields": ["id", "name", "domain", "industry", "custom_fields"]
  }'

​
Sorting

​
String format

{ "sort": "updated_at:desc" }

​
Object format

{ "sort": { "field": "created_at", "direction": "asc" } }

​
Supported sort fields

updated_at, created_at, name, domain, id

​
Default sort

updated_at desc

​
Filters

See Filters for the full operator reference and aliases.

​
Custom field example

{
  "filters": [
    {
      "field": "customer_tier",
      "operator": "eq",
      "value": "enterprise"
    }
  ]
}

​
Response

Identical shape to GET /accounts. Pass next_cursor back in the body to fetch the next page. Keep filters, sort, and limit the same across pages.