Skip to main content

Get Customer

This GET endpoint retrieves detailed information about a specific customer using their unique customer ID.

Endpoint

  • URL: /customers/{customer_id}
  • Method: GET

Path Parameters

ParameterTypeDescription
customer_idstringThe unique identifier of the customer to retrieve.

Authentication

  • Header: accessToken
  • Type: Bearer Token
  • Value: <ACCESS-TOKEN>

Request Headers

HeaderTypeDescription
accessTokenstringAccess token for authentication. (required)

Request Body

No request body is required for this GET operation.

Response

  • Status Code: 200 OK

Success Response Body

A successful response will return detailed information about the customer:

Main Response Fields

FieldTypeDescription
successbooleanIndicates if the request was successful.
dataobjectContains the details of the customer.

Customer Object (data)

FieldTypeDescription
emailstringEmail address of the customer.
firstNamestringFirst name of the customer.
lastNamestringLast name of the customer.
phoneNumberstringContact number of the customer.
rolestringRole ID associated with the customer.
companystringCompany ID related to the customer.
statusstringCurrent status of the customer (e.g., "pending").
verifiedEmailbooleanIndicates if the customer's email is verified.
newsletterbooleanIndicates subscription to the newsletter.
isB2BbooleanIndicates if the customer is a business customer.
metaFieldsarrayAdditional metadata related to the customer.
createdByobjectInformation about who created the customer entry.
createdAtstring (ISO 8601)Timestamp of when the customer was created.
updatedAtstring (ISO 8601)Timestamp of the last update to the customer data.
idstringUnique identifier for the customer.
addressobjectAddress information of the customer.

Error Responses

Status CodeDescription
401 UnauthorizedThe access token is invalid or missing.
403 ForbiddenYou do not have permission to access this resource.
404 Not FoundNo customer matches the specified customer_id.
500 Internal Server ErrorAn error occurred on the server.

Notes

  • Ensure the customer_id in the URL is replaced with the actual ID of the customer you wish to view.
  • Confirm your access token is valid and has permissions to access customer data.
  • This endpoint returns detailed customer information for authorized users.