Customers

A Customer represents a guest at a Trybe site.

A Customer is created when a guest creates an account on a Trybe shopfront, places a booking, or is created manually in the Trybe app.

Schema

Attributes

  • id

    The ID of the customer.

  • first_name
    Nullable

    The first name of the customer.

  • last_name
    Nullable

    The last name of the customer.

  • full_name
    Nullable

    The customer's full name

  • phone
    Nullable

    The customer's phone number in E.164 format, or null if not provided.

  • has_password

    Whether the user has a password

  • dob
    Nullable

    The customer's date of birth in YYYY-MM-DD format, or null if not provided.

  • brand_id

    The ID of the brand this customer belongs to

  • site_id

    The ID of the site this customer belongs to

  • stripe_id
    Nullable

    The Stripe Customer ID for this customer

  • express_stripe_id
    Nullable

    The Stripe Customer ID for this customer if they also exist in Trybe's legacy Stripe integration

  • email
    Nullable

    The email address of the customer.

    The case of the email address is not preserved, so you'll always see this in lowercase.

  • labels

    An array of labels associated with this customer

  • preferred_locale

    The preferred locale of the customer.

    This must be one of the platform's supported locales, which can be retrieved using the listMetaSupportedLocales endpoint.

  • locked_at
    Nullable

    The datetime which the customer was locked, or null if it has not been locked.

  • created_at

    The datetime which the customer was created

  • updated_at

    The datetime which the customer was last updated

  • deleted_at
    Nullable

    The datetime which the customer was anonymised, or null if it has not been.

  • last_active_at
    Nullable

    The datetime which the customer was last active

  • email_verified_at
    Nullable

    The datetime which the customer verified their email address

  • last_check_in
    Nullable

    A summary of the last check-in event associated with this customer, or null if they have never checked-in.

  • avatar_id
    Nullable

    The media ID of the customer's avatar, or null if one hasn't been provided.

  • avatar
    Nullable

    The media object of the customer's avatar, or null if one hasn't been provided.

  • external_ref
    Nullable

    An external reference for this customer.

""
actionCustomerSearch

Search for customers

Use this endpoint to search for customers.

Query parameters

  • site_id
    Required

    Filter results by the site they belong to

  • query
    Optional

    A general search query to match against customer fields.

  • source
    Optional

    Choose which sources to include in the search.

  • first_name
    Optional

    Filter by first name.

  • last_name
    Optional

    Filter by last name.

  • email
    Optional

    Filter by email address.

Responses

  • 200

    Customer search results

  • 422

    The search query was invalid

GET/shop/customers/search
200
example response
{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@example.com",
      "sources": [
        "trybe",
        "trybe"
      ],
      "labels": [
        {
          "id": "63114b48-fe15-077f-e5ff-bee11916634d",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "a99c3e6d-d143-537d-dd60-7d2c783d5a19",
          "name": "VIP",
          "color": "#FF5733"
        }
      ]
    },
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@example.com",
      "sources": [
        "trybe",
        "trybe",
        "trybe",
        "trybe"
      ],
      "labels": [
        {
          "id": "d487033d-69a7-0bcd-74ee-487db76e5465",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "62ddf1b5-3711-0d2f-37b2-aa8eb2ca2a89",
          "name": "VIP",
          "color": "#FF5733"
        }
      ]
    },
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane.smith@example.com",
      "sources": [
        "trybe",
        "trybe",
        "trybe",
        "trybe"
      ],
      "labels": [
        {
          "id": "6808c7a3-1375-45c4-05de-4adc77a7c15f",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "b83c8a72-7dac-0c1e-4362-69e538a519e3",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "e358f1f6-ad99-d199-c82e-2bd0e2b48184",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "6ceac4ac-8c87-9989-ac32-c21151a941ea",
          "name": "VIP",
          "color": "#FF5733"
        },
        {
          "id": "485d11ee-6b71-a601-259a-9dfdcf09f964",
          "name": "VIP",
          "color": "#FF5733"
        }
      ]
    }
  ],
  "meta": {
    "sources": []
  }
}
422
example response
{
  "errors": {
    "est_e": [
      "do aute dolor",
      "do ex est laboris",
      "deserunt ex",
      "incididunt dolore ea pariatur"
    ],
    "cillum_bbc": [
      "in adipisicing",
      "culpa dolor esse Duis dolore",
      "qui proident",
      "eiusmod"
    ]
  },
  "message": "The request didn't pass validation"
}
getCustomerStats

Get stats for a single customer across the whole organisation

Use this endpoint to retrieve high-level stats for a single customer.

Path parameters

  • customerId
    Required

    The ID of the customer being accessed.

Responses

  • 200

    Customer stats were found

  • 404

    The customer could not be found

GET/shop/customers/{customerId}/stats
200
example response
{
  "data": {
    "totals": {
      "total_order_value": 38500,
      "average_order_value": 19250,
      "num_orders": 2
    },
    "recent_orders": [
      {
        "id": "69316749213c190124000056",
        "order_ref": "qui commodo id proident aliquip",
        "status": "cancelled",
        "num_items": 2,
        "customer": {
          "id": "36c723cc-4465-2a19-9508-30ec8b43aae4",
          "email": "jane@example.com",
          "first_name": "Jane",
          "last_name": "Jones"
        },
        "sales_channel": {
          "id": "69316749213c190124000057",
          "name": "Website"
        },
        "totals": {
          "order_discount": 0,
          "total": 15000
        },
        "submitted_at": "1951-08-10T19:17:23.0Z",
        "site": {
          "id": "c9d4e36f-92e2-2b55-967a-004652677ffc",
          "name": "Palm Tree Spa"
        }
      },
      {
        "id": "69316749213c190124000058",
        "order_ref": "irure Excepteur",
        "status": "submitted",
        "num_items": 2,
        "customer": {
          "id": "3469d1f1-19b4-106e-79e4-22614da8676e",
          "email": "jane@example.com",
          "first_name": "Jane",
          "last_name": "Jones"
        },
        "sales_channel": {
          "id": "69316749213c190124000059",
          "name": "Website"
        },
        "totals": {
          "subtotal": 15000,
          "order_discount": 0,
          "total": 15000
        },
        "submitted_at": "1936-04-26T06:42:52.0Z",
        "site": {
          "id": "56d6f5cf-20db-2de1-518f-9b6948e15aaa",
          "name": "Palm Tree Spa"
        }
      },
      {
        "id": "69316749213c19012400005a",
        "order_ref": "ut veniam",
        "status": "settled",
        "num_items": 2,
        "customer": {
          "id": "bee6d05d-b873-ffba-6314-98121251a02e",
          "email": "jane@example.com",
          "first_name": "Jane",
          "last_name": "Jones"
        },
        "sales_channel": {
          "id": "69316749213c19012400005b"
        },
        "totals": {
          "subtotal": 15000,
          "order_discount": 0
        },
        "submitted_at": "1930-04-14T08:32:01.0Z",
        "site": {
          "id": "af4ac59f-55d4-42cc-acbc-981048a5774e",
          "name": "Palm Tree Spa"
        }
      }
    ]
  },
  "meta": {
    "currency": "gbp"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
listCustomers

List Customers

This endpoint lists the Customers which are associated to the provided site.

Query parameters

  • query

    Filters customers with a similar name, email or phone number to the given value

  • email

    Filter customers with the given email address

  • organisation_id

    Filter customers that belong to the given organisation ID

  • brand_id

    Filter customers that belong to the given brand ID

  • site_id

    Filter customers that belong to the given site ID

  • membership_number

    Filter customers that have a membership with the given membership number

  • name

    Filter customers with a similar name to the given value

  • phone

    Filter customers with the given phone number

  • membership

    Filter customers that have at least one membership of the given state. Set to "none" to filter customers that do not have any memberships, "any" to filter customers that have any memberships, and "needs_dd_mandate" for memberships awaiting a Direct Debit mandate or payment method.

  • membership_created_at_from

    Filters customers which have at least one membership that was created on or after the given date

  • membership_created_at_to

    Filters customers which have at least one membership that was created on or before the given date

  • membership_type_id

    Filters customers which have at least one membership of the given membership type ID

  • membership_rate_id

    Filters customers which have at least one membership of the given membership rate ID

  • marketing_opt_in

    Filters customers who are opted into the given marketing preference ID. Alternatively, pass "any" to filter customers opted into any marketing preference, or "none" to filter customers not opted into any preferences.

  • label_ids

    Filters customers which have the given CustomerLabel ids.

  • id

    Filters to just the customers with the given IDs.

  • page
    Optional

    The page to retrieve results from

  • per_page
    Optional

    The number of results to return per page

Responses

  • 200

    The Customers were successfully retrieved

GET/customers/customers
200
example response
{
  "data": [
    {
      "id": "786acaf5-fa47-9385-fade-badd1abf5e70",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1958-01-17",
      "brand_id": "1721f827-24df-19de-25c7-d3c023822881",
      "site_id": "a13ca638-c715-b597-0530-2354473aa5f8",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "228004f7-2e74-6f4e-6f17-4d5489d68a0d",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "0453ffad-8646-6c83-1762-a8634c8989af",
          "name": "VIP",
          "color": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1918-02-15T11:29:23.0Z",
      "created_at": "1947-11-21T09:08:06.0Z",
      "updated_at": "1946-04-06T04:14:21.0Z",
      "deleted_at": "1930-09-03T21:03:21.0Z",
      "last_active_at": "1961-12-27T04:10:59.0Z",
      "email_verified_at": "1901-04-28T13:02:28.0Z",
      "last_check_in": {
        "checked_in_at": "1904-07-11T19:17:55.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "59c11c61-e687-8f12-08fd-cdf24baa2af0",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo.jpg"
      },
      "external_ref": "occaecat sit sed"
    },
    {
      "id": "4d067c3a-fbd4-2803-3550-b962670f98ec",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1964-01-09",
      "brand_id": "f6ad95a9-82ce-d9cd-8783-3fc7c28e4645",
      "site_id": "909ae73b-8c72-4ca7-cbd6-76acf8068c2c",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [],
      "preferred_locale": "en",
      "locked_at": "1918-02-08T07:49:17.0Z",
      "created_at": "1960-06-09T01:23:58.0Z",
      "updated_at": "1924-03-12T18:03:21.0Z",
      "deleted_at": "1930-04-24T19:21:13.0Z",
      "last_active_at": "1936-07-10T11:23:36.0Z",
      "email_verified_at": "1922-04-01T09:20:01.0Z",
      "last_check_in": {
        "checked_in_at": "1933-06-29T09:25:42.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "6a47e37e-42fe-4b4a-6e7f-42b941ce0844",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo.jpg"
      },
      "external_ref": "qui fugiat in"
    },
    {
      "id": "4b9607d1-40a4-7e06-6593-d8ad949ccf89",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1931-07-16",
      "brand_id": "5120ed7f-2fbc-c2a7-baab-a76713d3798a",
      "site_id": "08fa0312-fea6-d969-63a0-defdbdb84221",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [],
      "preferred_locale": "en",
      "locked_at": "1924-12-26T05:27:08.0Z",
      "created_at": "1954-11-30T19:19:26.0Z",
      "updated_at": "1939-06-09T13:06:49.0Z",
      "deleted_at": "1928-09-27T01:33:59.0Z",
      "last_active_at": "1968-11-09T06:43:19.0Z",
      "email_verified_at": "1957-01-04T12:52:56.0Z",
      "last_check_in": {
        "checked_in_at": "1946-10-22T13:28:32.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "66d85fb6-63aa-9610-49f5-c9e889cdb439",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo.jpg"
      },
      "external_ref": "eu nisi labore Ut"
    },
    {
      "id": "985b2cc8-e435-4ffc-9396-550b7c3af2c3",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1902-05-08",
      "brand_id": "091b0b45-e4f9-ce26-e8fb-e2ff93d08e08",
      "site_id": "9083a9f7-f280-1791-acd2-72e5feb1799b",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "f42d4e0f-cd9a-b9bd-3e23-d5c7cb7ed2e2",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "2a38b7cb-bbfe-81e9-b93d-12d12a3c754e",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "4af73fe5-44d1-1a48-3202-65802905b442",
          "name": "VIP",
          "color": "ff6634"
        },
        {
          "id": "b4d0a4c8-a7ad-149a-969e-6e98419633be",
          "name": "VIP",
          "color": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1967-04-02T02:33:21.0Z",
      "created_at": "1944-05-11T02:39:30.0Z",
      "updated_at": "1892-02-23T06:21:32.0Z",
      "deleted_at": "1900-12-18T15:37:37.0Z",
      "last_active_at": "1901-12-01T02:07:34.0Z",
      "email_verified_at": "1918-08-01T21:02:19.0Z",
      "last_check_in": {
        "checked_in_at": "1914-05-24T11:45:51.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "7917f9a3-cea7-0cf3-a5c4-d61048a544fd",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo.jpg"
      },
      "external_ref": "in eu"
    }
  ],
  "meta": {
    "from": 1,
    "to": 2,
    "total": 2,
    "current_page": 1,
    "last_page": 2,
    "per_page": 15,
    "path": "http://example.com/api"
  },
  "links": {
    "first": "http://example.com?page=1",
    "next": "https://example.com?page=3",
    "prev": "https://example.com?page=1",
    "last": "https://example.com?page=4"
  }
}
createCustomer

Create a Customer

Use this endpoint to create a new Customer.

When creating a new Customer, you must specify at least one of the following fields along with any other fields marked as required:

  • email
  • first_name
  • last_name

Request body

  • site_id
    Required

    The ID of the site this customer belongs to

  • first_name
    Nullable

    The first name of the customer.

  • last_name
    Nullable

    The last name of the customer.

  • phone
    Nullable

    The customer's phone number in E.164 format, or null if not provided.

  • dob
    Nullable

    The customer's date of birth in YYYY-MM-DD format, or null if not provided.

  • email
    Nullable

    The email address of the customer.

    The case of the email address is not preserved, so you'll always see this in lowercase.

  • password

    The customer's password. This must be at least 8 characters long

  • marketing_preference_ids

    An array of marketing preference IDs to opt the customer in to

  • external_ref
    Nullable

    An external reference for this customer.

  • guestline_ref

    The guestline reference for this customer.

  • preferred_locale

    The preferred locale of the customer.

    This must be one of the platform's supported locales, which can be retrieved using the listMetaSupportedLocales endpoint.

Responses

  • 201

    The Customer was successfully retrieved

POST/customers/customers
201
example response
{
  "data": {
    "id": "0268dac9-5731-9b28-8ed3-e8d6519799b7",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1901-12-10",
    "brand_id": "362785b4-c310-4b90-d9c4-5e1bb65e2245",
    "site_id": "283d3ea8-170b-1d50-3873-2e3fbd03d33a",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "7e5256aa-70eb-3965-4259-6b0ff839c287",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "e55fb200-0e63-3c42-e8e3-ad71059f041a",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "f9b61c93-544c-6433-f313-146001494fa0",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1912-08-16T04:15:44.0Z",
    "created_at": "1945-06-12T19:11:15.0Z",
    "updated_at": "1894-10-16T08:47:26.0Z",
    "deleted_at": "1902-03-17T09:47:11.0Z",
    "last_active_at": "1951-08-06T15:06:44.0Z",
    "email_verified_at": "1899-12-08T20:16:15.0Z",
    "last_check_in": {
      "checked_in_at": "1940-02-19T01:14:28.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "0293ab41-1bbf-5e57-b34d-b06906a79e1a",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "aute magna Ut"
  }
}
getCustomer

Show a Customer

Use this endpoint to retrieve a Customer by their ID.

Path parameters

Responses

  • 200

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

GET/customers/customers/{customerId}
200
example response
{
  "data": {
    "id": "d1d24c7d-c901-69d3-6ee6-9275e744751c",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1934-01-01",
    "brand_id": "8b336f67-3a87-cece-5e2c-56c61b7556c3",
    "site_id": "9ab230af-da28-b176-b140-d4b7b55cea9f",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "714918ef-9e0f-32d2-388d-b5087a65b8fd",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "a1645781-8031-afb6-025e-7c0a0c189866",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1932-08-27T19:07:04.0Z",
    "created_at": "1928-05-05T02:49:24.0Z",
    "updated_at": "1947-03-12T05:10:39.0Z",
    "deleted_at": "1922-03-17T13:53:19.0Z",
    "last_active_at": "1922-05-11T23:52:14.0Z",
    "email_verified_at": "1899-03-06T01:05:11.0Z",
    "last_check_in": {
      "checked_in_at": "1910-02-28T01:41:58.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "9ef6262f-920b-f1f1-ae46-311de33741da",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "esse tempor in eu Excepteur"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
updateCustomer

Update a Customer

Use this endpoint to update an existing Customer.

Path parameters

Request body

  • first_name
    Nullable

    The first name of the customer.

  • last_name
    Nullable

    The last name of the customer.

  • phone
    Nullable

    The customer's phone number in E.164 format, or null if not provided.

  • dob
    Nullable

    The customer's date of birth in YYYY-MM-DD format, or null if not provided.

  • password

    The customer's password. This must be at least 8 characters long

  • external_ref
    Nullable

    An external reference for this customer.

  • preferred_locale

    The preferred locale of the customer.

    This must be one of the platform's supported locales, which can be retrieved using the listMetaSupportedLocales endpoint.

Responses

  • 201

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

PUT/customers/customers/{customerId}
201
example response
{
  "data": {
    "id": "c2dc42b8-68f6-e074-a93b-282c9b93bcbd",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1940-09-08",
    "brand_id": "cd10d771-43e2-f773-0c4d-ee80bb39ec64",
    "site_id": "15b75560-8bc9-39c7-11e7-61de51335386",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "47f05c44-e133-5f33-3c9d-08bea1e786f7",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "70e421f1-8fbe-8e57-2c17-55eb987292e3",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1904-07-31T10:17:55.0Z",
    "created_at": "1932-04-19T06:19:49.0Z",
    "updated_at": "1927-03-06T23:54:45.0Z",
    "deleted_at": "1906-06-10T01:03:17.0Z",
    "last_active_at": "1967-03-04T12:22:34.0Z",
    "email_verified_at": "1921-01-08T17:36:42.0Z",
    "last_check_in": {
      "checked_in_at": "1905-07-30T20:54:39.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "78b0f31b-e26d-eb55-65e9-0db161c75ba8",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "adipisicing"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
listAssociatedBarcodes

List Associated Barcodes for a Customer

This endpoint retrieves all barcodes associated with a customer.

Path parameters

Responses

  • 200

    The barcodes associated with the customer were successfully retrieved

GET/customers/customers/{customerId}/barcodes
200
example response
{
  "data": [
    {
      "id": "ac6f486e-0ca3-ae75-d647-4f03da479dd8",
      "customer_id": "dcc08094-baea-de97-d80a-220d8e3ab896",
      "barcode": "est fugiat aliquip",
      "expires_at": "1927-10-07T16:23:55.0Z",
      "brand_id": "d5a6d110-27ec-7a68-dcd8-51c54aa58797",
      "site_id": "687d9d7a-b31f-695f-2b7c-32e37f4772a3",
      "organisation_id": "aefb959e-1829-c77b-54d9-df7bdc800028",
      "source": "kiosk",
      "order_id": "abe9fc0d-71bb-c28a-ee22-1df84c09e5d9",
      "payment_method": {
        "id": "c0287562-0ae2-2259-6384-43aae8b49053",
        "payment_method_id": "pm_3K6a0RGysTOePye00nkob5Pi",
        "name": "My debit card",
        "type": "direct_debit",
        "status": "revoked",
        "cardholder_name": "Jane Doe",
        "card_brand": "amex",
        "card_country": "gb",
        "card_funding": "credit",
        "card_expiry": "08/22",
        "last_4": "1234",
        "processor": "stripe",
        "created_at": "2025-01-01T01:01:01.0Z",
        "updated_at": "2025-01-01T01:01:01.0Z",
        "revoked_at": "2025-01-01T01:01:01.0Z"
      },
      "created_at": "1964-07-21T07:28:10.0Z"
    },
    {
      "site_id": "32a2dd9c-6516-3da7-b8e6-9710c4cd8b78",
      "order_id": "67a159e7-c99e-1842-3721-a312f806c84f"
    }
  ]
}
updateWearableExpiryDate

Update the Expiry Date for a Wearable Device

This endpoint updates the expiry date for a wearable device associated with a customer.

Path parameters

Request body

  • expires_at
    Required
    Nullable

    The expiry date for the wearable device.

Responses

  • 200

    The payment method for the wearable device was successfully retrieved

PUT/customers/customers/{customerId}/barcodes/{barcodeId}/expiry-date
200
example response
{
  "data": {
    "id": "875d33a2-1bb9-978a-e73f-8405ad93e61b",
    "customer_id": "94720cb5-db9c-3c19-84e0-a504a9f3f8b3",
    "barcode": "adipisicing in labore reprehenderit dolor",
    "expires_at": "1918-12-31T07:40:27.0Z",
    "brand_id": "1a84651e-cec7-d2b8-4037-5083bfdf6cc0",
    "site_id": "7e7ab1bb-336e-2668-9723-dc4882f49264",
    "organisation_id": "d4911ba5-2d90-cae4-5537-88b4c601234a",
    "source": "kiosk",
    "order_id": "91f494ba-5641-631d-8e4d-570174899ead",
    "payment_method": {
      "id": "fa237950-1427-67a5-3b53-23ed6b76a4e7",
      "payment_method_id": "pm_3K6a0RGysTOePye00nkob5Pi",
      "name": "My debit card",
      "type": "direct_debit",
      "status": "revoked",
      "cardholder_name": "Jane Doe",
      "card_brand": "amex",
      "card_country": "gb",
      "card_funding": "credit",
      "card_expiry": "08/22",
      "last_4": "1234",
      "processor": "stripe",
      "created_at": "2025-01-01T01:01:01.0Z",
      "updated_at": "2025-01-01T01:01:01.0Z",
      "revoked_at": "2025-01-01T01:01:01.0Z"
    },
    "created_at": "1907-12-16T15:18:31.0Z"
  }
}
updateWearablePaymentMethod

Update a Payment Method for a Wearable Device

This endpoint updates the payment method assigned to a wearable device for a customer.

Path parameters

Request body

  • payment_method_id
    Required

    The ID of the payment method to associate with the wearable device.

Responses

  • 200

    The payment method for the wearable device was successfully retrieved

PUT/customers/customers/{customerId}/barcodes/{barcodeId}/payment-method
200
example response
{
  "data": {
    "id": "37d97e53-ab01-96e3-a65b-0b151da522c3",
    "customer_id": "324151c2-5c38-74c2-5886-cb703b0d30f0",
    "barcode": "consequat",
    "expires_at": "1899-07-29T13:38:08.0Z",
    "brand_id": "33421a61-7c8b-af4f-6c6c-7d3ac08bbafd",
    "site_id": "ad565b00-c65c-a289-5c10-75419c92dec1",
    "organisation_id": "9b7b7824-2a43-bd81-e262-9091d77aecad",
    "source": "kiosk",
    "order_id": "bc591301-5a49-e3a4-e367-ce3e95183727"
  }
}
getCustomerMemberships

List a customer's memberships

Use this endpoint to retrieve a list of Memberships for the given Customer.

When retrieving memberships with this endpoint, the next_charge property will be populated if applicable.

Path parameters

Responses

  • 200

    The customer's Memberships were successfully retrieved

  • 404

    The resource couldn't be found

GET/customers/customers/{customerId}/memberships
200
example response
{
  "data": [
    {
      "id": "8b976338-d75f-cef4-c6ae-7e926cc8b6f1",
      "site_id": "5d9c7eb8-3731-955e-fc99-f3ed2def2467",
      "membership_number": "1234567890",
      "customer": {
        "id": "777a82a5-5a69-94e6-8aea-7734de619b86",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1929-09-09",
        "brand_id": "9b6a1d2a-f316-6921-eda4-c7540b704194",
        "site_id": "b50bc23a-861e-2621-f7fc-b260a21f3e98",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "eee2660e-8589-8eb1-b6e7-a463eec75c20",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "ed941dc5-98f2-e236-4cba-0271b6d1d489",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "9bd41a3a-37e6-c66a-3d08-78b9deea550a",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "287ad51e-e53b-69cf-0ab7-e55b095b9718",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1896-02-25T19:52:25.0Z",
        "created_at": "1909-07-28T16:07:34.0Z",
        "updated_at": "1941-03-19T14:51:15.0Z",
        "deleted_at": "1911-01-15T09:06:01.0Z",
        "last_active_at": "1961-02-06T01:13:15.0Z",
        "email_verified_at": "1910-12-17T16:19:45.0Z",
        "last_check_in": {
          "checked_in_at": "1895-06-10T05:01:17.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "77ec4888-0afc-ce6c-55e4-e6ffae03b1a5",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "nulla Excepteur"
      },
      "members": [
        {
          "membership_number": "1234567890",
          "is_lead": false
        }
      ],
      "type": {
        "id": "e7318539-e6f5-0c98-dffc-57b7160a4ceb",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "elit magna ea ipsum velit",
        "brand_id": "ad47ad79-736b-e657-ddba-a9a32266a30a",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1924-09-18T10:48:09.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "f4fbc275-4812-20a2-e7f3-114c39acf051",
            "membership_type_id": "9ddfc4fc-99f0-3d06-d5ef-c9d79499f048",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000
          },
          {
            "id": "0e317eac-ba0a-2763-5639-d59e481dbe7b",
            "membership_type_id": "bf961aff-bd2f-8f57-a154-683ba117be4a",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "default_duration": "P1Y",
            "created_at": "1940-09-24T09:53:17.0Z",
            "updated_at": "1893-02-24T03:14:45.0Z"
          },
          {
            "id": "6115389d-99d9-3adb-b5e8-6b836b9a4db9",
            "membership_type_id": "1dc0640f-5659-2bc1-754b-457c4b4b36b7",
            "name": "Standard rate",
            "joining_fee": 1000,
            "default_duration": "P1Y"
          },
          {
            "id": "25892950-ce19-9684-fab0-0b6280133f72",
            "membership_type_id": "36853920-b8cf-27a3-882c-80be29c8c06f",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "billing_frequency": "P1M",
            "private": true,
            "created_at": "1895-06-28T04:36:25.0Z",
            "updated_at": "1947-10-26T14:06:28.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1967-11-24T20:05:12.0Z",
        "updated_at": "1949-03-17T10:44:28.0Z",
        "deleted_at": "1936-03-17T06:43:07.0Z"
      },
      "rate": {
        "id": "6568d1e9-3759-fedb-2f69-0139ed13f394",
        "membership_type_id": "429015d8-2dfb-77e0-64ba-9658be9075a6",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "tax": 1250,
        "billing_frequency": "P1M",
        "processors": [
          "in ut adipisicing"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1937-10-23T01:06:40.0Z",
        "updated_at": "1926-01-04T23:01:25.0Z"
      },
      "status": "active",
      "source": "app",
      "payment_method": {
        "id": "Lorem",
        "type": "card",
        "last_4": "est",
        "status": "revoked",
        "card_brand": "amex"
      },
      "start_date": "1894-05-13T20:40:16.0Z",
      "end_date": "1961-12-25T23:23:06.0Z",
      "created_at": "1957-09-21T07:56:36.0Z"
    },
    {
      "id": "17bebb8f-44fc-83e5-87c1-2a5b0067ccb3",
      "site_id": "2abd7244-df5e-a0aa-66ea-0bce053815e3",
      "membership_number": "1234567890",
      "customer": {
        "id": "cc0e3732-945b-2be0-e8a6-ef3a8af79c38",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1906-01-10",
        "brand_id": "a42709f9-651c-e154-eb19-7a8cfc1c2465",
        "site_id": "3e7c8748-47de-c7b5-417f-1c6be613e818",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "1690e5f3-cb67-acf0-5767-18c34f6950f1",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "40122c2f-bda6-baf2-f123-e86a09f3f305",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "7acb0f9c-97b1-75fa-5ce7-b673413e206d",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "c9a26d04-d8c0-11b7-390b-2841ef45a013",
            "name": "VIP",
            "color": "ff6634"
          },
          {
            "id": "ca5acad6-abe2-3398-963f-97df0ed5d34b",
            "name": "VIP",
            "color": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1911-09-29T18:38:40.0Z",
        "created_at": "1956-03-02T23:49:26.0Z",
        "updated_at": "1924-10-06T11:24:56.0Z",
        "deleted_at": "1967-03-13T04:05:08.0Z",
        "last_active_at": "1946-01-12T11:05:19.0Z",
        "email_verified_at": "1908-02-22T15:31:44.0Z",
        "last_check_in": {
          "checked_in_at": "1961-03-21T05:56:15.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "aafe6d73-e177-8c3a-e60a-661cbc7959cd",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo.jpg"
        },
        "external_ref": "laborum cupidatat Duis"
      },
      "members": [],
      "type": {
        "id": "0c02b2c6-9c2a-521c-6078-916053efe37d",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "ullamco ut nostrud incididunt",
        "brand_id": "585abb81-fc94-5063-22e7-a8f2feca863d",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "minimum_start_date": "1911-10-22T08:04:10.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "name": "Standard rate",
            "private": true
          },
          {
            "currency": "GBP",
            "price": 5000,
            "billing_frequency": "P1M",
            "processors": [
              "aliquip elit deserunt occaecat consectetur",
              "pariatur",
              "ipsum reprehenderit sed minim veniam",
              "commodo veniam elit",
              "reprehenderit nulla amet adipisicing mollit"
            ],
            "created_at": "1910-11-10T11:06:09.0Z"
          },
          {
            "id": "3c9c66b4-65ac-7f8a-4625-62bd3be9ec92",
            "membership_type_id": "7ef323fb-f091-10a5-37dd-f45b844e465e",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "tax": 1250,
            "billing_frequency": "P1M",
            "processors": [
              "nostrud sunt amet eu eiusmod",
              "minim laborum aliqua esse eu",
              "Lorem commodo occaecat Ut nostrud"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1969-11-17T06:37:19.0Z"
          },
          {
            "id": "2625349d-81df-24f2-a411-414aaf550df1",
            "name": "Standard rate",
            "tax": 1250,
            "processors": [
              "deserunt quis elit et"
            ],
            "private": true,
            "created_at": "1893-05-27T21:52:07.0Z"
          },
          {
            "id": "8000c66c-d290-e921-eb5a-f8e1aa4824c3",
            "membership_type_id": "0550327e-3a3b-d9e4-39fd-505d04ad393d",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "tax": 1250,
            "private": true
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1911-10-04T04:28:24.0Z",
        "updated_at": "1906-01-12T02:06:01.0Z",
        "deleted_at": "1969-12-18T08:10:10.0Z"
      },
      "rate": {
        "id": "81591d87-cd54-0c02-3e69-a091b97f2fc2",
        "membership_type_id": "d9d5c0e3-c292-4993-70fd-c6589bfab880",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "tax": 1250,
        "billing_frequency": "P1M",
        "processors": [
          "ut exercitation qui",
          "et elit",
          "commodo sed ut",
          "deserunt id nostrud est"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1893-09-08T04:25:13.0Z",
        "updated_at": "1904-02-28T16:51:31.0Z"
      },
      "status": "needs_dd_mandate",
      "source": "import",
      "payment_method": {
        "id": "ex exercitation fugiat magna",
        "type": "card"
      },
      "start_date": "1953-07-12T13:42:37.0Z",
      "next_charge": {
        "id": "1cfb4540-e531-cf10-fe14-db4402a88d5c",
        "amount": 3995,
        "currency": "GBP",
        "status": "errored",
        "billing_period_from": "1902-04-12",
        "billing_period_to": "1952-10-11"
      }
    }
  ],
  "meta": {
    "from": 1,
    "to": 2,
    "total": 2,
    "current_page": 1,
    "last_page": 2,
    "per_page": 15,
    "path": "http://example.com/api"
  },
  "links": {
    "first": "http://example.com?page=1",
    "next": "https://example.com?page=3",
    "prev": "https://example.com?page=1",
    "last": "https://example.com?page=4"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionLockCustomer

Lock a Customer

Use this endpoint to lock a Customer.

When a customer is locked, their details cannot be modified until their profile is unlocked.

Any requests to updateCustomer or anonymiseCustomer will fail with a 400 response.

Path parameters

Responses

  • 200

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

POST/customers/customers/{customerId}/lock
200
example response
{
  "data": {
    "id": "b2493399-8cda-cca7-68c4-d47a1d9bbaa8",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1923-07-03",
    "brand_id": "1c3e496d-1dc9-507d-5978-b76b46168bf3",
    "site_id": "e7b075dd-c789-9aa3-a581-753f1b58c75b",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "3a9cc226-c922-f3aa-8186-6c7c8e57e0e0",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1953-02-25T22:33:54.0Z",
    "created_at": "1926-07-11T15:27:55.0Z",
    "updated_at": "1906-03-11T01:45:57.0Z",
    "deleted_at": "1938-10-28T04:49:30.0Z",
    "last_active_at": "1953-08-23T09:02:01.0Z",
    "email_verified_at": "1968-02-08T23:25:33.0Z",
    "last_check_in": {
      "checked_in_at": "1957-02-17T19:28:29.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "f20e720a-6e34-35d7-1f4b-8abb09e7b427",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "dolore commodo officia"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionUnlockCustomer

Unlock a Customer

Use this endpoint to unlock a Customer.

Path parameters

Responses

  • 200

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

POST/customers/customers/{customerId}/unlock
200
example response
{
  "data": {
    "id": "64e4698d-a297-d8b3-460b-d9fc981c16ec",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1935-12-30",
    "brand_id": "3acac3f6-5d85-e083-bd08-4a919f712a83",
    "site_id": "45a30050-f4ae-19bb-5031-33ae5a932d5a",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [],
    "preferred_locale": "en",
    "locked_at": "1921-08-29T12:58:08.0Z",
    "created_at": "1939-03-02T06:32:43.0Z",
    "updated_at": "1935-11-01T17:05:49.0Z",
    "deleted_at": "1950-07-02T18:15:39.0Z",
    "last_active_at": "1940-09-22T03:21:09.0Z",
    "email_verified_at": "1922-06-29T07:19:53.0Z",
    "last_check_in": {
      "checked_in_at": "1897-06-11T17:44:13.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "4a7f2b2e-1390-f370-a9fa-69d2d8e0fec4",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "proident ad"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionTriggerCustomerPasswordReset

Trigger reset password

Use this endpoint to trigger a password reset for a Customer.

The customer will receive a URL via email which they can use to reset their password.

The URL will be valid for 1 hour.

Path parameters

Responses

  • 200

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

POST/customers/customers/{customerId}/reset-password
200
example response
{
  "data": {
    "id": "1bebeab2-b7d0-91ca-c738-5f0ef9a004b9",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1904-10-30",
    "brand_id": "d92f0c9d-aeb2-0811-db0f-eda6f691221e",
    "site_id": "f6dc8d03-29b2-73f9-a1b3-21992778fd76",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "a1670c93-6f9e-949a-9d26-a9631fbc8bb9",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "c5db62a1-ab92-bd0f-dc55-a6808d2386e0",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "bbb358eb-8fed-212c-4900-f98e6c5382b8",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "2e017593-7ff3-aa94-1970-9527d6b4b2fe",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "3cca63fd-885c-0cf4-a1cb-66e5973801b7",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1927-06-10T20:37:44.0Z",
    "created_at": "1916-08-05T13:57:35.0Z",
    "updated_at": "1935-09-07T22:31:27.0Z",
    "deleted_at": "1915-10-22T18:41:11.0Z",
    "last_active_at": "1917-08-25T22:27:45.0Z",
    "email_verified_at": "1894-11-01T15:32:16.0Z",
    "last_check_in": {
      "checked_in_at": "1902-01-16T20:33:48.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "510b4218-bd38-3840-1e4f-895deb28ec95",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "occaecat qui"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionResendCustomerVerification

Resend verification

Use this endpoint to resend the email verification email for a Customer.

The customer will receive a URL via email which they can use to verify their email address.

Path parameters

Responses

  • 200

    The Customer was successfully retrieved

  • 404

    The resource couldn't be found

POST/customers/customers/{customerId}/resend-verification
200
example response
{
  "data": {
    "id": "31c51cc1-e250-519f-d796-4e59894de2e7",
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "phone": "+447900000000",
    "has_password": true,
    "dob": "1949-07-07",
    "brand_id": "248dce1d-4939-2437-c680-80ad53cbe6d5",
    "site_id": "9376a240-5132-3940-ede8-b8d9fa227f89",
    "stripe_id": "cus_1234567890",
    "express_stripe_id": "cus_1234567890",
    "email": "janedoe@example.com",
    "labels": [
      {
        "id": "51f21d3c-a911-bb47-eee4-a10559f8e75c",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "41221815-970b-7818-38f2-e10f533e92b4",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "e88e92c4-693c-37d6-5896-b40ce12f8741",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "511f1605-f098-5029-4f2c-2dcdbba5269e",
        "name": "VIP",
        "color": "ff6634"
      },
      {
        "id": "7bb2e8df-20d7-9366-09fa-baf41436dbd5",
        "name": "VIP",
        "color": "ff6634"
      }
    ],
    "preferred_locale": "en",
    "locked_at": "1960-08-14T15:37:12.0Z",
    "created_at": "1897-11-16T21:57:24.0Z",
    "updated_at": "1949-03-17T12:16:11.0Z",
    "deleted_at": "1919-09-04T06:44:09.0Z",
    "last_active_at": "1947-03-23T17:33:39.0Z",
    "email_verified_at": "1966-01-16T22:25:28.0Z",
    "last_check_in": {
      "checked_in_at": "1925-03-09T18:07:20.0Z",
      "method": "Scanned"
    },
    "avatar_id": "000000-000000-000000-000000",
    "avatar": {
      "id": "2ec23e7a-c69b-d167-7ba2-37a6e38e94ee",
      "file_name": "super-cool-photo.jpg",
      "mime_type": "image/jpeg",
      "size": 84256,
      "url": "https://example.com/media/super-cool-photo.jpg"
    },
    "external_ref": "ex"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}