List customers

GET

/v1/customers

• Production (nep_live_ keys)
• Local development

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

cursor

string

Opaque cursor from a previous response’s nextCursor.

limit

integer

default: 20 >= 1 <= 100

Page size (max 100).

search

string

Match on email or name.

status

string

Allowed values: active archived

Responses

200

A page of customers.

object

items

Array<object>

object

id

string

cus_01ARZ3NDEKTSV4RRFFQ69G5FAW

email

string format: email

name

string

phone

string

+9779800000000

metadata

Up to 50 key/value string pairs you can attach to an object. Trile ignores them; they’re returned on every read.

object

key

additional properties

string

{
  "internal_user_id": "42"
}

createdAt

string format: date-time

nextCursor

Pass back as cursor; null on the last page.

string | null

401

Missing or invalid API key.

object

success

boolean

error

object

code

string

insufficient_funds

message

string

Wallet balance is below the first cycle amount.

meta

object

requestId

string

req_aBcDeFgHiJkL