Get Accounts

The workspace ID used to scope the request. You can find the workspace ID in the app URL:

https://app.accoil.com/48/scores/{workspace_id}/accounts/{id} Example: For the URL https://app.accoil.com/48/scores/123/accounts/154, the workspace_id is 123

The account trait to match against. Common values include:

• domain: Company domain (e.g., example.com)
• name: Account or organization name
• intercom_id: Intercom company ID
• salesforce_id: Salesforce account ID
• tracking_id: Your external tracking identifier
• Or any custom trait you've recorded in Accoil

The exact value to match for the specified match_type. For example, if match_type=domain, use match_value=example.com.

The internal Accoil account ID.

This is the fastest and most direct way to retrieve engagement data for an account.

You can find the account ID in the app URL:

https://app.accoil.com/48/scores/{workspace_id}/accounts/{id}

Example: For the URL https://app.accoil.com/48/scores/123/accounts/154, the id is 154

A comma-separated list of optional data blocks to include in the response.

Available options:

• insights: AI-generated analysis of account health and engagement, with actionable recommendations.
• traits: All account attributes, including custom properties.
• segments: Segmentation and grouping information assigned to the account.

Example: expand=insights,traits

Cache Durations: The following cache/refresh periods apply to expand options

• insights: Cached for up to 30 minutes (updates less frequently)
• traits: Cached for up to 15 minutes
• segments: Cached for up to 10 minutes (more likely to change often)

Note: Cache durations reflect how often data is refreshed on the server. If you poll the API more frequently than this, you may receive unchanged data.