Skip to main content
GET
/
v2
/
inbound
/
accounts
List accounts
curl --request GET \
  --url https://enrich.octolane.com/v2/inbound/accounts \
  --header 'X-API-Key: <x-api-key>'
Simple list endpoint for Accounts with basic text search and cursor pagination.
Filters and sorting are not supported on this endpoint. Use POST /accounts/search when you need them.

​
Request

​
X-API-Key
string
required
Your Octolane API key.

​
Query parameters

​
q
string
Basic text search across account name and domain.
​
cursor
string
Opaque cursor from a previous response. See Cursor pagination.
​
limit
number
default:"100"
Page size. Max 500.
​
fields
string
Comma-separated fields or JSON-encoded string array.

​
Example request

curl "https://enrich.octolane.com/v2/inbound/accounts?limit=10&q=acme&fields=id,name,domain,custom_fields" \
  -H "X-API-Key: your-api-key"

​
Response fields

​
Common fields

id, name, domain, logo, created_at, updated_at, first_interaction, last_interaction, custom_fields

​
Additional system fields

industry, tags, linkedin, twitter, description, primary_location, founded, estimated_revenue, employee_range, type, next_meeting

​
Example response

200
{
  "success": true,
  "requestId": "req-id",
  "data": {
    "accounts": [
      {
        "id": "f3e0cab5-1c28-4fca-8fdf-7f555afbe967",
        "name": "Acme Inc",
        "domain": "acme.com",
        "industry": "Software",
        "created_at": "2026-05-01T10:00:00.000Z",
        "updated_at": "2026-05-25T09:30:03.285Z",
        "custom_fields": {
          "customer_tier": "enterprise"
        }
      }
    ],
    "custom_field_definitions": {
      "customer_tier": {
        "current_name": "Customer Tier",
        "property_name": "select_530",
        "attribute_type": "select",
        "metadata": null
      }
    },
    "has_more": true,
    "next_cursor": "opaque_cursor_token",
    "limit": 10
  },
  "message": "Accounts fetched successfully",
  "statusCode": 200
}