GET
/v1/customers/{id}Retrieves a single customer by their ID. Use this endpoint to fetch detailed customer information for display or editing. The response includes customer data and associated user information. Organization members can access customers who have checkouts with their organization's products. Requires CustomerRead permission on the target customer.
Parameters
Request parameters for this endpoint
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | Required | Customer ID to retrieve |
Response Data
Fields returned in the response
Always Present
| Name | Type | Description |
|---|---|---|
createdAt | string (date-time) | Timestamp when the customer record was created |
creditStatus | Current credit check status (unknown, passed, or failed) | |
id | CustomerPubId | Public-facing unique identifier for the customer |
identityVerificationStatus | Identity verification status (none, pending, processing, verified, failed) | |
updatedAt | string (date-time) | Timestamp when the customer record was last updated |
userId | UserId | User account associated with this customer |
Optional
| Name | Type | Description |
|---|---|---|
address1 | string | Primary street address line |
address2 | string | Optional secondary address line (apartment, suite, etc.) |
city | string | City name |
country | string | Country code (ISO format) |
creditIpAddress | string | IP address used when performing the credit check |
creditTimestamp | string | Timestamp when the credit check was performed |
phone | string | Phone number of the customer |
state | string | State or province code |
stripeId | string | Stripe customer ID for payment processing (production) |
stripeSandboxId | string | Stripe customer ID for payment processing (sandbox) |
stripeVerificationSessionId | string | Stripe Identity verification session ID |
zip | string | Postal or ZIP code |
GET
/v1/customers/{id}Request
curl https://api.thesweetspot.com/v1/customers/id_123 \
-H "Content-Type: application/json"Response
{
"createdAt": "2026-02-04T03:45:27.277Z",
"creditStatus": null,
"id": null,
"identityVerificationStatus": null,
"updatedAt": "2026-02-04T03:45:27.277Z",
"userId": "string"
}