---
title: "Get customer by ID"
method: GET
path: "/customers/{customer_id}"
tags: ["Customers"]
---

# Get customer by ID

`GET /customers/{customer_id}`

## Request

- Base URL: `https://aml-api.elliptic.co/v2`
- URL: `https://aml-api.elliptic.co/v2/customers/{customer_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-access-key` and API key in header `x-access-sign` and API key in header `x-access-timestamp`

Get a single customer by ID

## Path parameters

- `customer_id` string, UUIDv4, required

## Query parameters

- `expand` string[]
- `isMc` boolean

## Response `200`

Customer successfully retrieved

- Customer: an object representing a single Customer
  - `id` string, UUIDv4, required: UUIDv4 identifier of the customer
  - `updated_at` string, date-time: ISO date time with time zone (UTC) of when the customer was last updated
  - `created_at` string, date-time: Customer's creation's ISO date time with time zone (UTC)
  - `team_id` string, UUIDv4, required: UUIDv4 identifier of the team the user belongs to
  - `investigator_id` string, NullableUUIDv4: UUIDv4 identifier of the user assigned to investigate customer
  - `reference` string, required: used by our client to refer to this customer
  - `labels` union[]: list of labels applied to the customer. If not expanded then just array of {"id":// uuid, label ids }
    - union
      - string
      - object
  - `status` 'processing' | 'error' | 'complete': customer's status
  - `is_processing` boolean: true if a query on this customer currently processing
  - `has_errors` boolean: true if a query on this customer has errored
  - `last_queried` string, date-time, required: ISO date time with time zone (UTC) of when the last query was run
  - `workflow_status` 'active' | 'archived', required: the workflow status
  - `statistics` object: an object representing aggregated statistics for a single customer
    - `first_tx_time` string, date-time, nullable, required: ISO date time with time zone (UTC) of the transaction having the smallest transaction time
    - `last_tx_time` string, date-time, nullable, required: ISO date time with time zone (UTC) of the transaction having the biggest transaction time
    - `avg_score` number, float, nullable, required: average between all this customer's transactions risks
    - `max_score` number, float, nullable, required: the highest risk of this customer's transactions risks
    - `min_score` number, float, nullable: the minimum risk of this customer's transactions risks
    - `total_volume` number, nullable, required: sum of all customer transactions output satoshis
    - `total_fees` number, nullable: sum of all customer transactions fees
    - `customer_tx_count` number, nullable, required: total number of customer_txs that this customer has
    - `deposits` CustomerTxInfo, required: an object representing a single analysed Transaction attached to a Customer
      - `total_volume` number, nullable, required: Sum of all transactions' volume
      - `customer_tx_count` number, nullable, required: Number of transactions
      - `total_fees` number, nullable: sum of all customer transactions fees
    - `withdrawals` CustomerTxInfo, required: an object representing a single analysed Transaction attached to a Customer
      - `total_volume` number, nullable, required: Sum of all transactions' volume
      - `customer_tx_count` number, nullable, required: Number of transactions
      - `total_fees` number, nullable: sum of all customer transactions fees
    - `min_output_satoshis` number, nullable, required: the lowest volume of this customer's transactions volumes
    - `max_output_satoshis` number, nullable, required: the highest volume of this customer's transactions volumes
    - `avg_output_satoshis` number, nullable, required: average of this customer's transactions volumes

## Other responses

- `401`: Not authenticated
- `403`: Not authorized
- `404`: Customer ID not found
- `500`: Server Error

---

[API](https://skmtc.dev/elliptic/apis/aml-api-v2.md) - [All operations](https://skmtc.dev/elliptic/apis/aml-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/elliptic/apis/aml-api-v2/revisions/e0bcbfe65e14?raw)