Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Elliptic Customers API

The customers endpoints are used to manage customers which you have associated analysis with, via the `customer_reference` analysis subject attribute.Currently, the customers endpoints only refer to customers with [Transaction Analysis](#tag/Transaction-Analyses).Customers with only [Wallet Analysis](#tag/Wallet-Analyses) will not yield responses from these endpoints

Elliptic Customers API is one of 16 APIs that Elliptic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Customers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.

This API exposes 6 operations across 6 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://aml-api.elliptic.co/v2.

6 operations 6 paths 10 schemas 4 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://aml-api.elliptic.co
Authentication
OAuth 2.0, API Key, API Key, API Key
Resource Areas
1

Authentication & Security 4

Elliptic Customers API declares 4 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 2 scopes. An API key is passed in the header as x-access-key (apiKey). An API key is passed in the header as x-access-sign (signature). An API key is passed in the header as x-access-timestamp (timestamp). By default, every request must be authenticated.

  • apiKey — API Key
  • signature — (Request Time, HTTP Method, Lowercase Path, Request Payload) signed with API Secret

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 4 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Customers 6

The customers endpoints are used to manage customers which you have associated analysis with, via the customerreference analysis subject attribute. Currently, the customers endpoi…

GET
/customers
Paginate all customers
28 params → 200400401403500
GET
/customers/{customer_id}
Get customer by ID
3 params → 200401403404500
POST
/customers/investigator
Bulk update investigator ID
body → 204400401403500
POST
/customers/workflow_status
Bulk update workflow status
body → 204400401403500
GET
/copilot/customers/summary/{customerId}
Get customer summary
getCustomerSummary 2 params → 200400401403404500
GET
/copilot/customers/summary/{customerId}/transaction-assets
Get customer transaction assets
getTransactionAssetsByCustomerId 1 param → 200400401403404500

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Customer (13 properties), ErrorResponse (4 properties), CustomerTxInfo (3 properties), NotFoundError (2 properties). Each schema is shown below with its type and property counts.

UnauthorizedError
string
ErrorResponse
object
4 properties 3 required
SummaryResult
object
Full customer summary including an LLM narrative and the analysis IDs used to generate it
2 properties 2 required
MaxRiskTrigger
object
A wallet or transaction at the maximum risk score, with its hash and analysis ID
2 properties 2 required
BadRequestError
object
2 properties
Customer
object
an object representing a single Customer
13 properties 5 required
CustomerTxInfo
object
an object representing a single analysed Transaction attached to a Customer
3 properties 2 required
Error
object
2 properties
NotFoundError
object
2 properties
ForbiddenError
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

elliptic-customers-api-openapi.yml Raw ↑

Other APIs Elliptic publishes across the network.

Elliptic Assets API
Elliptic Count Analyses API
Elliptic Criteria API
Elliptic Health API
Elliptic Risk Rules API
Elliptic Sanctions API
Elliptic Screenings API
Elliptic Transaction Analyses API
Elliptic Transaction Workflow API
Elliptic Tron NodeIntelligence API
Elliptic Users API
Elliptic Wallet Analyses API