---
title: "Get customer summary"
method: GET
path: "/copilot/customers/summary/{customerId}"
tags: ["Customers"]
---

# Get customer summary

`GET /copilot/customers/summary/{customerId}`

Returns a summary for a customer by ID. The shape of the response depends on the `request` query parameter.

## Path parameters

- `customerId` string, uuid, required

## Query parameters

- `request` 'overview' | 'wallet' | 'transaction' | 'wallet_ids' | 'transaction_ids'

## Response `200`

Customer summary. Shape depends on `request` query param: `SummaryResult` when omitted, LLM narrative string for `overview`/`wallet`/`transaction`, or `MaxRiskTrigger[]` for `wallet_ids`/`transaction_ids`.

- union
  - SummaryResult — Full customer summary including an LLM narrative and the analysis IDs used to generate it
    - `summary` string, required — LLM-generated customer summary
    - `analysisIds` object, required
      - `wallets` string[], required — Wallet analysis IDs used in the summary
      - `transactions` string[], required — Transaction analysis IDs used in the summary
  - MaxRiskTrigger[] — Highest-risk items with hash and analysisId (returned when request is wallet_ids or transaction_ids)
    - `hash` string, required — Wallet address or transaction hash
    - `analysisId` string, uuid, required — Analysis ID (UUID)

## Other responses

- `400` — Bad request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid authentication token
- `403` — Forbidden - Insufficient permissions
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.dev/elliptic/apis/ai-api.md) · [All operations](https://skmtc.dev/elliptic/apis/ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elliptic/ai-api/revisions/4a97f07f10ff/schema)