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
The unique identifier (SSO ID) of the customer to retrieve.Example:
1234-5678-9012-3456Response
Unique identifier for the customer.
Customer’s email address.
Customer’s first name.
Customer’s last name.
Customer’s phone number.
Associated Stripe customer ID for payment processing.
ISO 8601 date when the customer account was activated.
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