customers

Get customer

Get a customer by Paid display ID. Use the value returned as customer.id, for example cus_abc123. If you have your own customer ID, use GET /api/v2/customers/external/{externalId}.

get/customers/{id}

Request

  • Base URL: https://api.agentpaid.io/api/v2
  • URL: https://api.agentpaid.io/api/v2/customers/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Paid customer display id

Response

200

idstring required

Stable Paid customer display ID. Use this value as the {id} path parameter for customer routes, for example GET /api/v2/customers/cus_abc123/state.

namestring required
legalNamestring nullable required
emailstring required
phonestring required
websitestring required
externalIdstring nullable required
creationState'draft' | 'active' required
status'active' | 'churned' required

Customer status: churned when the customer is marked as churned, active otherwise.

churnDatestring date-time nullable required
vatNumberstring nullable required
metadataobject nullable required
defaultCurrencystring required

ISO 4217 currency code, for example USD, EUR, or GBP.

createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.