Retrieves a single customer by their ID. Use this endpoin...

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

Name	Type	Required	Description
address1	string	Optional	Primary street address line
address2	string	Optional	Optional secondary address line (apartment, suite, etc.)
city	string	Optional	City name
country	string	Optional	Country code (ISO format)
createdAt	string (date-time)	Required	Timestamp when the customer record was created
creditIpAddress	string	Optional	IP address used when performing the credit check
creditStatus		Required	Current credit check status (unknown, passed, or failed)
creditTimestamp	string	Optional	Timestamp when the credit check was performed
id	CustomerPubId	Required	Public-facing unique identifier for the customer
phone	string	Optional	Phone number of the customer
state	string	Optional	State or province code
stripeId	string	Optional	Stripe customer ID for payment processing (production)
stripeSandboxId	string	Optional	Stripe customer ID for payment processing (sandbox)
updatedAt	string (date-time)	Required	Timestamp when the customer record was last updated
userId	UserId	Required	User account associated with this customer
zip	string	Optional	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": "2025-12-10T18:00:54.211Z",
  "creditStatus": null,
  "id": null,
  "updatedAt": "2025-12-10T18:00:54.211Z",
  "userId": "string"
}