curl --location --request GET 'https://api.stateset.com/v1/customers/1234-5678-9012-3456' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
query getCustomer($sso_id: uuid!) {
customers: customers_by_pk(sso_id: $sso_id) {
sso_id
activationDate
email
firstName
lastName
phone
stripe_customer_id
timestamp
}
}
const customer = await stateset.customers.retrieve(
'1234-5678-9012-3456'
);
customer = stateset.customers.retrieve(
'1234-5678-9012-3456'
)
customer = Stateset::Customers.retrieve(
'1234-5678-9012-3456'
)
customer, err := stateset.Customers.Retrieve(
"1234-5678-9012-3456",
)
$customer = $stateset->customers->retrieve(
'1234-5678-9012-3456'
);
Customer customer = stateset.customers().retrieve(
"1234-5678-9012-3456"
);
{
"customer": {
"sso_id": "1234-5678-9012-3456",
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"phone": "+1-555-123-4567",
"stripe_customer_id": "cus_1234567890",
"activationDate": "2024-01-15T00:00:00.000Z",
"timestamp": "2024-06-01T12:30:00.000Z"
}
}
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Customer not found",
"details": {
"resource": "customer",
"id": "1234-5678-9012-3456"
},
"request_id": "req_abc123def456"
}
}
{
"error": {
"code": "INVALID_API_KEY",
"message": "The API key provided is invalid or has been revoked",
"request_id": "req_abc123def456"
}
}
Get Customer
Retrieve a single customer by their unique identifier
GET
/
v1
/
customers
/
:id
curl --location --request GET 'https://api.stateset.com/v1/customers/1234-5678-9012-3456' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
query getCustomer($sso_id: uuid!) {
customers: customers_by_pk(sso_id: $sso_id) {
sso_id
activationDate
email
firstName
lastName
phone
stripe_customer_id
timestamp
}
}
const customer = await stateset.customers.retrieve(
'1234-5678-9012-3456'
);
customer = stateset.customers.retrieve(
'1234-5678-9012-3456'
)
customer = Stateset::Customers.retrieve(
'1234-5678-9012-3456'
)
customer, err := stateset.Customers.Retrieve(
"1234-5678-9012-3456",
)
$customer = $stateset->customers->retrieve(
'1234-5678-9012-3456'
);
Customer customer = stateset.customers().retrieve(
"1234-5678-9012-3456"
);
{
"customer": {
"sso_id": "1234-5678-9012-3456",
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"phone": "+1-555-123-4567",
"stripe_customer_id": "cus_1234567890",
"activationDate": "2024-01-15T00:00:00.000Z",
"timestamp": "2024-06-01T12:30:00.000Z"
}
}
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Customer not found",
"details": {
"resource": "customer",
"id": "1234-5678-9012-3456"
},
"request_id": "req_abc123def456"
}
}
{
"error": {
"code": "INVALID_API_KEY",
"message": "The API key provided is invalid or has been revoked",
"request_id": "req_abc123def456"
}
}
Returns the full customer object including profile, address, and integration details.
Path Parameters
string
required
The unique identifier (SSO ID) of the customer to retrieve.Example:
1234-5678-9012-3456Response
string
Unique identifier for the customer.
string
Customer’s email address.
string
Customer’s first name.
string
Customer’s last name.
string
Customer’s phone number.
string
Associated Stripe customer ID for payment processing.
string
ISO 8601 date when the customer account was activated.
string
ISO 8601 timestamp of the last update to the customer record.
curl --location --request GET 'https://api.stateset.com/v1/customers/1234-5678-9012-3456' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
query getCustomer($sso_id: uuid!) {
customers: customers_by_pk(sso_id: $sso_id) {
sso_id
activationDate
email
firstName
lastName
phone
stripe_customer_id
timestamp
}
}
const customer = await stateset.customers.retrieve(
'1234-5678-9012-3456'
);
customer = stateset.customers.retrieve(
'1234-5678-9012-3456'
)
customer = Stateset::Customers.retrieve(
'1234-5678-9012-3456'
)
customer, err := stateset.Customers.Retrieve(
"1234-5678-9012-3456",
)
$customer = $stateset->customers->retrieve(
'1234-5678-9012-3456'
);
Customer customer = stateset.customers().retrieve(
"1234-5678-9012-3456"
);
{
"customer": {
"sso_id": "1234-5678-9012-3456",
"email": "jane.doe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"phone": "+1-555-123-4567",
"stripe_customer_id": "cus_1234567890",
"activationDate": "2024-01-15T00:00:00.000Z",
"timestamp": "2024-06-01T12:30:00.000Z"
}
}
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Customer not found",
"details": {
"resource": "customer",
"id": "1234-5678-9012-3456"
},
"request_id": "req_abc123def456"
}
}
{
"error": {
"code": "INVALID_API_KEY",
"message": "The API key provided is invalid or has been revoked",
"request_id": "req_abc123def456"
}
}
⌘I