---
title: "Get a customer"
method: GET
path: "/v1/customers/{id}"
tags: ["Customers"]
---

# Get a customer

`GET /v1/customers/{id}`

Retrieve a customer by their ID. Requires a secret key (`sk_*`).

## Path parameters

- `id` string, required

## Response `200`

Customer details

- object — Customer details
  - `id` string, required — Internal customer ID
  - `businessId` string, required — Business ID this customer belongs to
  - `name` string, nullable — Customer display name
  - `externalCustomerId` string, nullable — Your system customer ID (null if created with onchainAddress only)
  - `stripeCustomerId` string, nullable — Stripe customer ID linked via Connect or migration
  - `onchainAddress` string, nullable — Smart account address (null for internal customers)
  - `email` string, email, nullable — End-customer email used for invoice receipt delivery (null if not set)
  - `isInternal` boolean, required — Internal customer (visibility only, no billing)
  - `status` 'ACTIVE' | 'LOW_BALANCE' | 'PAUSED', required — Customer status
  - `metadata` object, nullable — Arbitrary metadata attached to the customer
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `401` — Unauthorized
- `404` — Customer not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)