API ReferenceUsers

Retrieve a customer

Retrieve a customer by customer_identifier. This endpoint returns the editable customer profile and current budget usage fields.

Path parameters

customer_identifierstringRequired
Your unique identifier for this customer.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Query parameters

environmentenumOptional
Optional environment filter. If omitted, the backend uses the environment implied by your auth context when applicable.
Allowed values:

Response

Customer details.
idstring
Customer identifier used by the detail serializer.
namestring or null
Customer display name.
emailstring or null
Customer email address.
customer_identifierstring
Your unique identifier for the customer.
environmentenum
Customer environment.
Allowed values:
total_budgetdouble or null
Lifetime spending budget in USD.
period_budgetdouble or null
Current period budget in USD.
organization_namestring or null
Owning organization name.
total_period_usagedouble
Usage in the current budget period in USD.
period_startdatetime
Start of the current budget period.
period_enddatetime or null
End of the current budget period.
budget_durationenum
Budget renewal period.
Allowed values:
updated_atdatetime
Last update timestamp.

Errors

401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error