Memberships

A Membership represents a membership belonging to one or more Customers.

Schema

Attributes

  • The ID of the membership

  • A string describing what kind of action needs to take place

    Possible values are no_mandate, setup_unpaid, mandate_revoked, payment_failed, payment_disputed, payment_outstanding and site_id

  • The basket ID which was used to purchase this membership, if applicable.

  • end_date
    Nullable

    The date which the membership ends

  • An external reference for this membership.

  • The unique membership number of the lead member. This is always a 10 digit numeric string. Since this field only relates to the lead member, this is now deprecated. Instead, find the membership for the relevant customer in the members array.

  • The date which the membership will next be billed

  • next_charge
    Nullable

    A summary of the next charge that's due for this membership.

    This property is only populated when the membership was retrieved using the `getCustomerMemberships endpoint.

  • Details about the payment method attached to this membership. This payment method is used to take payment on the monthly billing period. If a payment method hasn't been set up, this will be null.

  • The ID of the site this membership belongs to

  • Where the membership was created

    Possible values are self_signup, app, import and unknown

  • The date which the membership starts

  • Possible values are active, needs_dd_mandate, needs_attention, reserved, inactive, expired and upcoming

  • A URL to a page where the member can provide their payment details.

  • The datetime which the membership was created

""
listMemberships

List Memberships

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

Query parameters

  • Filters memberships belonging to the specified customer

  • page
    Optional

    The page to retrieve results from

  • per_page
    Optional

    The number of results to return per page

Responses

  • 200

    The Memberships were successfully retrieved

GET/customers/memberships
200
example response
{
  "data": [
    {
      "id": "cc691300-645e-3b86-5626-4f705bd734ea",
      "attention_reason": "payment_failed",
      "basket_id": "69ab08ddc1cc92013c0002eb",
      "customer": {
        "id": "fc29d855-0e5d-ebf8-3067-bafee9ecaa05",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1942-05-23",
        "brand_id": "b14095d2-7a66-8598-a38d-3fedd1ae29bd",
        "site_id": "0b28c217-b145-a11c-971e-59f336d3806b",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "1cb5371a-74be-cc5f-f4b0-b21096fff3fc",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "88b464bb-08c4-ee7d-3787-1392b9064ecf",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "4dffc26f-fb82-a2ca-e291-a8bfaec85811",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "73aaad01-89df-7093-88ac-868a59b9cff1",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "c2a1a83c-e3c7-84d2-0f87-c2a19982bf47",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1942-03-10T02:03:47.0Z",
        "created_at": "1902-01-23T18:03:01.0Z",
        "updated_at": "1933-12-29T20:53:30.0Z",
        "deleted_at": "1932-08-11T18:11:40.0Z",
        "last_active_at": "1952-06-03T20:59:30.0Z",
        "email_verified_at": "1905-06-26T01:59:28.0Z",
        "last_check_in": {
          "checked_in_at": "1914-06-11T09:15:22.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "c49d4484-b72c-14c6-7774-aed6e48611e9",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "proident id"
      },
      "end_date": "1948-03-21T14:28:14.0Z",
      "external_ref": "eiusmod cillum",
      "members": [
        {
          "customer_id": "1e6985fb-0124-a170-c149-2086964e0cbd",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "2c332219-73f8-4f3d-fbf0-3a6b44a15e70",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "501b0d1e-ed02-081f-15a9-5cb86aefebeb",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "bdd842cc-ce1e-237f-5624-861e3f084002",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1932-01-16T01:29:55.0Z",
      "next_charge": {
        "id": "674e573d-a827-0232-ab24-c53e329cbcbc",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1932-07-24",
        "billing_period_to": "1901-01-02"
      },
      "payment_method": {
        "id": "magna Ut",
        "type": "card",
        "last_4": "aute et anim",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "41e39e90-d90a-e220-2658-ed33e5f69a1e",
        "membership_type_id": "a84179f3-8a62-b56f-dfbf-e4fe6515ae26",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "labore esse quis",
          "occaecat ipsum qui Duis sunt"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1958-05-22T21:34:17.0Z",
        "updated_at": "1895-01-31T23:07:29.0Z"
      },
      "site_id": "fd5a7437-14f0-dad5-692a-54bad9bf64c3",
      "source": "app",
      "start_date": "1896-02-03T21:11:31.0Z",
      "status": "active",
      "status_updated_at": "1956-09-26T13:22:32.0Z",
      "type": {
        "id": "f42a4288-15ff-890a-5acf-e62625ea2252",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "ut sed pariatur irure",
        "brand_id": "1f55cca6-8006-aa25-e8ba-313aaad68f9b",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1906-02-15T23:37:15.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "8968a41d-ec1c-590b-8a45-560e2d10193d",
            "membership_type_id": "14181850-39db-759e-8e9e-78e8cf0ce9d8",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1946-04-21T19:49:51.0Z",
            "updated_at": "1963-10-29T22:29:25.0Z"
          },
          {
            "id": "04dee664-78cf-4a9b-587c-274486e6c312",
            "membership_type_id": "7d486167-9b3c-f094-8365-e86b25c959ee",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1962-11-05T05:55:14.0Z",
            "updated_at": "1969-01-14T11:46:27.0Z"
          },
          {
            "id": "1b85cc29-e278-0a31-c132-b7924e88613b",
            "membership_type_id": "1634fb3d-3655-6074-7250-190d4af3c567",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1940-08-13T18:45:04.0Z",
            "updated_at": "1962-09-26T06:04:42.0Z"
          },
          {
            "id": "d024eba5-318a-b52f-7070-d8d63a241cd8",
            "membership_type_id": "95d70364-714d-be27-f3ca-9392082677c6",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "elit Excepteur",
              "adipisicing elit deserunt ut consequat",
              "voluptate ut in dolor",
              "velit sit",
              "cillum sed Lorem"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1959-09-21T02:26:47.0Z",
            "updated_at": "1952-07-24T07:30:22.0Z"
          },
          {
            "id": "2ca98439-9131-c721-c437-f6725b6b071e",
            "membership_type_id": "2f64bb33-a6e8-9965-bc9c-3e24f44b0685",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "et veniam",
              "labore occaecat qui quis minim",
              "quis",
              "eu"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1936-12-30T07:14:04.0Z",
            "updated_at": "1929-04-11T20:41:32.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1964-08-06T22:53:08.0Z",
        "updated_at": "1921-11-01T02:04:59.0Z",
        "deleted_at": "1900-10-07T01:57:57.0Z"
      },
      "payment_details_url": "laboris ea dolor",
      "created_at": "1930-04-09T23:57:37.0Z"
    },
    {
      "id": "b1d3db3b-eb33-112a-1d63-fa98b21d7213",
      "attention_reason": "setup_unpaid",
      "basket_id": "69ab08ddc1cc92013c0002ec",
      "customer": {
        "id": "b9923994-0bcd-868a-2279-d2cad5cbc132",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1953-09-23",
        "brand_id": "8fe1ff16-d513-0fd8-2f76-a992ff42b032",
        "site_id": "4944effd-6fa6-b4f2-c496-2d7093d3934e",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "854a94ed-2913-a45e-c5fc-7d7b1482531a",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "41f2e54e-d8b6-368f-4066-cd0a2f5e5c33",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "a80ea4b2-75df-5836-1db9-a1574e802837",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "c7bb94b7-88c7-1437-c98e-61fb3f3a0a77",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1918-05-31T19:58:07.0Z",
        "created_at": "1895-08-02T13:32:16.0Z",
        "updated_at": "1905-09-18T22:22:59.0Z",
        "deleted_at": "1898-04-08T06:52:03.0Z",
        "last_active_at": "1933-04-17T16:08:38.0Z",
        "email_verified_at": "1945-08-16T15:13:50.0Z",
        "last_check_in": {
          "checked_in_at": "1953-02-10T10:57:05.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "a649ef8a-82f3-646c-cafb-74f4a80bbb3e",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "tempor"
      },
      "end_date": "1892-07-27T23:36:30.0Z",
      "external_ref": "ullamco",
      "members": [
        {
          "customer_id": "0f505e92-6d37-faef-0ae2-debf035411b5",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "e3e379a2-49b1-d31d-4e7d-84cb539f8254",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "79b6137e-0a15-b2f4-040e-6fc33e14c819",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1931-05-10T21:18:34.0Z",
      "next_charge": {
        "id": "e94ed71a-7a85-0ff2-2cdd-1d5270ea2646",
        "amount": 3995,
        "currency": "GBP",
        "status": "succeeded",
        "billing_period_from": "1959-07-07",
        "billing_period_to": "1912-10-06"
      },
      "payment_method": {
        "id": "aliquip consectetur Ut",
        "type": "direct_debit",
        "last_4": "deserunt dolor dolore",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "3bf0fe28-198a-cf9b-8bc3-46ab0e1e16c0",
        "membership_type_id": "2a0724cc-d38b-04d5-24ce-9aad0a678b92",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "nisi cupidatat",
          "eiusmod sit",
          "sunt elit in cupidatat",
          "dolore veniam"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1897-07-28T07:07:10.0Z",
        "updated_at": "1915-03-01T03:44:13.0Z"
      },
      "site_id": "1a579787-69d6-091b-e9c3-2ee9f26ce36e",
      "source": "import",
      "start_date": "1969-08-12T04:28:57.0Z",
      "status": "inactive",
      "status_updated_at": "1934-12-19T02:54:35.0Z",
      "type": {
        "id": "0749da92-af2d-338c-8323-16c907d661b3",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "Ut pariatur adipisicing eiusmod",
        "brand_id": "e51ec466-ca9b-2e5f-91b4-435d2052f00b",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1968-10-02T21:49:06.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "c90cff4b-62d5-eac3-e4bb-138bf94927c9",
            "membership_type_id": "c11c5100-ba7a-1480-a6d4-cb3ddf741a34",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ullamco qui elit",
              "est dolor velit reprehenderit eu",
              "nisi"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1947-06-22T10:58:43.0Z",
            "updated_at": "1904-03-20T01:27:33.0Z"
          },
          {
            "id": "a1de8374-2a90-3588-a2c1-93e3465bbda5",
            "membership_type_id": "59b4ea5e-cc7c-f851-659a-49e7086f7837",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "culpa mollit qui cillum aute",
              "dolor irure laborum dolore proident"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1963-11-24T16:36:15.0Z",
            "updated_at": "1948-09-24T01:53:11.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1919-09-02T04:54:56.0Z",
        "updated_at": "1922-04-20T01:40:38.0Z",
        "deleted_at": "1968-01-28T22:05:17.0Z"
      },
      "payment_details_url": "ullamco",
      "created_at": "1959-01-22T06:39:43.0Z"
    },
    {
      "id": "bb8fe62b-12f8-4ec3-d36b-6ca3c2621e9e",
      "attention_reason": "payment_disputed",
      "basket_id": "69ab08ddc1cc92013c0002ed",
      "customer": {
        "id": "e5f382b1-9fd5-4454-ab66-27077cfebbe7",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1961-10-15",
        "brand_id": "d21c4cef-90f6-57a5-c29a-0ad1683b6ce7",
        "site_id": "da68e599-857c-891c-77ce-678d88a386d6",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "dedd056a-5b23-7af9-176d-c8dc7f047a81",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "79c0a0f5-f08a-b4b6-0ba9-300576559e14",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1911-11-26T08:59:09.0Z",
        "created_at": "1925-02-22T15:54:29.0Z",
        "updated_at": "1905-02-17T17:34:46.0Z",
        "deleted_at": "1907-04-02T22:46:05.0Z",
        "last_active_at": "1918-04-24T03:05:42.0Z",
        "email_verified_at": "1954-02-06T19:54:44.0Z",
        "last_check_in": {
          "checked_in_at": "1910-12-24T12:25:45.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "e532f67e-0b59-84e0-bed6-d537da4a8c37",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "sit commodo et magna voluptate"
      },
      "end_date": "1927-12-13T03:14:55.0Z",
      "external_ref": "esse ea officia",
      "members": [
        {
          "customer_id": "3a90a1ed-63f3-01a4-8361-ee78150d5359",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "8866ba52-4791-2945-4fac-7ddb08b1393e",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1900-08-31T02:16:05.0Z",
      "next_charge": {
        "id": "dad30c7f-843f-c63c-b044-7f204eb44a7d",
        "amount": 3995,
        "currency": "GBP",
        "status": "errored",
        "billing_period_from": "1890-08-07",
        "billing_period_to": "1932-04-19"
      },
      "payment_method": {
        "id": "dolore anim minim labore",
        "type": "card",
        "last_4": "laboris veniam quis"
      },
      "rate": {
        "id": "009f6c27-3309-b587-1081-87fb95a3cf51",
        "membership_type_id": "10adb3af-c217-e900-0b67-f15a7752a014",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1917-06-30T14:37:54.0Z",
        "updated_at": "1904-08-09T17:57:38.0Z"
      },
      "site_id": "34c36ff3-c57c-a824-347c-99b6910dcacf",
      "source": "self_signup",
      "start_date": "1901-10-23T05:23:54.0Z",
      "status": "inactive",
      "status_updated_at": "1961-05-28T12:50:08.0Z",
      "type": {
        "id": "bb454c40-ba94-30cf-1e2d-53b741f8e109",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "proident magna dolore fugiat",
        "brand_id": "174f1a84-f70a-f3fc-c279-5c08d9dc7b8c",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": false,
        "visibility": "public",
        "minimum_start_date": "1933-09-28T10:55:01.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "366d1508-593b-1858-af06-a373b74bac30",
            "membership_type_id": "43bf68c9-197d-3785-8491-1baffe096e26",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1918-02-22T01:25:21.0Z",
            "updated_at": "1925-01-17T19:08:54.0Z"
          },
          {
            "id": "35a82828-6395-01b6-2e6b-e324952d1c50",
            "membership_type_id": "f498073b-1720-57b2-45db-a5e58dd364a1",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "officia",
              "fugiat irure quis",
              "exercitation",
              "sint Excepteur in"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1944-11-21T04:36:26.0Z",
            "updated_at": "1916-05-06T04:16:13.0Z"
          },
          {
            "id": "4aeeba23-6370-7510-3158-71f2de6bbd7b",
            "membership_type_id": "8a3ed1e6-75d9-d3e8-f1ec-a8d05aa1a74f",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ea quis ullamco proident enim",
              "ullamco Excepteur in nostrud"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1941-10-03T14:49:40.0Z",
            "updated_at": "1963-08-14T11:29:31.0Z"
          },
          {
            "id": "850adb56-a13b-3185-c1b2-0e38f83363cf",
            "membership_type_id": "2a62f7c7-fcb6-468b-6cdc-6ac017dc4422",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "tempor exercitation sit",
              "eiusmod irure quis",
              "id irure reprehenderit",
              "Ut"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1921-09-30T05:48:41.0Z",
            "updated_at": "1912-12-24T04:34:11.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1926-06-07T03:23:04.0Z",
        "updated_at": "1896-03-28T06:54:46.0Z",
        "deleted_at": "1911-06-04T10:58:37.0Z"
      },
      "payment_details_url": "exercitation Ut amet",
      "created_at": "1899-01-25T01:58:33.0Z"
    },
    {
      "id": "a1b76ad3-bf42-8dd4-2c0d-a0c1d7d2b990",
      "attention_reason": "no_mandate",
      "basket_id": "69ab08ddc1cc92013c0002ee",
      "customer": {
        "id": "3f7f8b0f-a0c4-a1e6-3507-2275d1e04bdd",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1898-12-03",
        "brand_id": "c4e18be8-71f0-bc6b-fa65-e804f2a283d5",
        "site_id": "028ad375-b0b5-f856-83d8-c0b6fb41f353",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "27e11285-2be3-9a14-51a3-9a16171e8dd5",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "12981a07-f89a-5b88-40a1-40920a22409a",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1922-09-11T23:58:31.0Z",
        "created_at": "1891-04-28T10:31:47.0Z",
        "updated_at": "1923-10-30T16:40:31.0Z",
        "deleted_at": "1951-09-11T01:52:46.0Z",
        "last_active_at": "1932-04-19T01:26:40.0Z",
        "email_verified_at": "1934-12-22T12:39:31.0Z",
        "last_check_in": {
          "checked_in_at": "1922-02-05T23:55:56.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "a383d4d4-275d-8717-b295-493ec1be4e18",
          "file_name": "super-cool-photo.jpg",
          "mime_type": "image/jpeg",
          "original_url": "https://example.com/media/super-cool-photo.jpg",
          "size": 84256,
          "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
        },
        "external_ref": "laborum ipsum dolor"
      },
      "end_date": "1954-06-28T19:44:01.0Z",
      "external_ref": "minim ut",
      "members": [
        {
          "customer_id": "83d50350-a6a7-91dc-677c-55a901c68a45",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1943-01-25T17:09:15.0Z",
      "next_charge": {
        "id": "7a926bbf-fdc3-5163-a402-1c344c1cbcde",
        "amount": 3995,
        "currency": "GBP",
        "status": "processing",
        "billing_period_from": "1901-04-01",
        "billing_period_to": "1963-08-16"
      },
      "payment_method": {
        "id": "deserunt adipisicing tempor",
        "type": "card",
        "card_brand": "amex"
      },
      "rate": {
        "id": "3faa05a6-80e5-5c3b-4002-b34af79296c7",
        "membership_type_id": "45a5787b-2a7a-dbf1-bddf-955580bd6022",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "labore deserunt",
          "magna minim labore et sint",
          "veniam incididunt",
          "commodo fugiat cillum ex",
          "Excepteur ullamco anim laborum adipisicing"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1949-02-08T07:23:25.0Z",
        "updated_at": "1943-07-13T09:35:59.0Z"
      },
      "site_id": "d9f621b9-c0f4-89e2-23d8-c6953a6cb17c",
      "source": "app",
      "start_date": "1966-11-09T01:07:26.0Z",
      "status": "upcoming",
      "status_updated_at": "1941-07-09T11:48:18.0Z",
      "type": {
        "id": "055dba43-012a-5cc8-60fc-1dc56b363697",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "sint mollit Ut officia",
        "brand_id": "26c626a5-332a-87ae-68c1-4594b9ecad9b",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1925-03-09T13:12:38.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1890-06-21T09:56:32.0Z",
        "updated_at": "1953-12-06T14:40:42.0Z",
        "deleted_at": "1899-06-10T22:47:20.0Z"
      },
      "payment_details_url": "pariatur qui",
      "created_at": "1917-11-27T18:22:06.0Z"
    }
  ],
  "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"
  }
}
getMembership

Show a membership

Use this endpoint to retrieve a Membership by its ID.

Path parameters

Responses

  • 200

    The Membership was successfully retrieved

  • 404

    The resource couldn't be found

GET/customers/memberships/{membershipId}
200
example response
{
  "data": {
    "id": "35670898-1cab-96e9-59d3-1d604ab78a19",
    "attention_reason": "site_id",
    "basket_id": "69ab08ddc1cc92013c0002ef",
    "customer": {
      "id": "72bb2a88-4ba2-acb6-c071-3f77fad0bc48",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1928-04-10",
      "brand_id": "296dfaf7-cfc1-3dc4-3bde-5702650463fe",
      "site_id": "d9e35521-7fe6-78cf-72a6-1160af92653d",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "0f41cf70-d27a-3f61-ccc7-b87301ad7b82",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "9a809ae6-7720-6b0a-64e0-afef609688b2",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "5531a757-43ff-4fd5-a872-90f47af5f243",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "18ceee8a-96a5-b370-d01f-6f03e8adf1b7",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1894-09-02T14:16:08.0Z",
      "created_at": "1959-11-30T22:43:47.0Z",
      "updated_at": "1945-09-20T10:24:25.0Z",
      "deleted_at": "1911-03-23T23:47:05.0Z",
      "last_active_at": "1947-03-27T12:35:45.0Z",
      "email_verified_at": "1945-11-18T11:24:08.0Z",
      "last_check_in": {
        "checked_in_at": "1946-08-01T22:25:12.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "5868d2ce-1bdb-175e-6b29-a1902dcf4823",
        "file_name": "super-cool-photo.jpg",
        "mime_type": "image/jpeg",
        "original_url": "https://example.com/media/super-cool-photo.jpg",
        "size": 84256,
        "url": "https://example.com/media/super-cool-photo-thumbnail@2x.jpg"
      },
      "external_ref": "deserunt dolor"
    },
    "end_date": "1952-07-01T01:17:20.0Z",
    "external_ref": "amet",
    "members": [
      {
        "customer_id": "3e5848b0-7869-f8df-4c52-19b4c0efecbd",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "435b61db-ce2c-7e14-6d27-9d6ca2e47e43",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "0531a170-c967-9bf9-c591-f5e71ecbfb89",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "ffc60606-1104-9df1-b8c6-6454c59fc1c1",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "29918ad1-fca2-a4a6-d2af-1b1731f740f0",
        "is_lead": false,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1919-02-10T14:28:19.0Z",
    "next_charge": {
      "id": "1908cd11-9c7b-9a6b-64b3-d7c7f2f919cb",
      "amount": 3995,
      "currency": "GBP",
      "status": "failed",
      "billing_period_from": "1929-08-17",
      "billing_period_to": "1897-05-27"
    },
    "payment_method": {
      "id": "quis cillum nostrud id fugiat",
      "type": "direct_debit",
      "last_4": "do sit commodo Duis nisi",
      "status": "revoked",
      "card_brand": "amex"
    },
    "rate": {
      "id": "a7b10732-08b2-8c7b-7539-f85bf5d15c3f",
      "membership_type_id": "1ee01f71-6ba6-5bd9-f10e-ba2212dbe002",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "elit"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1919-07-22T18:39:35.0Z",
      "updated_at": "1965-02-20T05:16:17.0Z"
    },
    "site_id": "5487b1ae-1993-aa98-451c-1f7cbdbcb116",
    "source": "self_signup",
    "start_date": "1948-01-13T18:07:06.0Z",
    "status": "needs_dd_mandate",
    "status_updated_at": "1910-09-29T03:45:01.0Z",
    "type": {
      "id": "8d373c81-ebf4-5ac5-b9e9-f6c147c0b5c5",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "Lorem aute occaecat",
      "brand_id": "c8200085-263a-ec15-b30d-9dfea27304af",
      "offline_payments": false,
      "disable_confirmation_email": false,
      "private": false,
      "visibility": "public",
      "minimum_start_date": "1908-07-04T23:07:22.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "dee59d67-94a6-b847-309a-278fb52c507a",
          "membership_type_id": "65194b27-c837-fdc0-a705-673cb6ba2795",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "officia",
            "in consectetur",
            "occaecat sed proident qui consectetur",
            "sunt",
            "pariatur cillum exercitation commodo"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1968-07-12T18:39:40.0Z",
          "updated_at": "1936-11-19T19:47:45.0Z"
        },
        {
          "id": "577830de-21a9-0733-fbf3-1c6f7cb49414",
          "membership_type_id": "42d2e825-537c-052a-ffec-da4f7c21af48",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "incididunt",
            "laboris dolor elit"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1907-07-03T19:34:59.0Z",
          "updated_at": "1960-02-22T18:35:25.0Z"
        },
        {
          "id": "c3f98606-bb99-34b0-a8fd-0f094fee502e",
          "membership_type_id": "91ce9af2-e57c-1af2-0f20-b2a826c752fa",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "pariatur in",
            "nostrud in amet dolor dolor",
            "cillum laboris",
            "cupidatat consequat"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1928-02-16T16:15:14.0Z",
          "updated_at": "1928-06-10T19:46:26.0Z"
        },
        {
          "id": "87d7fce7-2d81-3227-0db9-cdc4621b977f",
          "membership_type_id": "95da09a6-7af6-7071-b0e6-723c3da63c9d",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "pariatur ut",
            "Lorem ex mollit tempor aliquip"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1942-01-25T21:32:12.0Z",
          "updated_at": "1952-05-10T21:53:42.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1905-06-12T10:41:20.0Z",
      "updated_at": "1904-03-27T14:25:08.0Z",
      "deleted_at": "1894-02-02T22:58:20.0Z"
    },
    "payment_details_url": "ad Ut deserunt laborum",
    "created_at": "1967-03-02T10:05:52.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionAddMembershipChargePayment

Record a manual payment against a charge

This endpoint allows a manual (off-Trybe) payment to be recorded against a membership charge.

Path parameters

Request body

  • The ID of the custom payment type this payment should be recorded as

  • amount
    Nullable

    The amount of the payment

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/payment
200
example response
{
  "data": {
    "id": "a2bfbf56-cc22-1541-fbb8-6d2ca5e7dae4",
    "membership": {
      "id": "a0513524-9064-3626-8f99-dc8cca60aa69",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "fda4be7f-7c1a-2be3-3ebc-ee58eb0321c8",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69ab08dec1cc92013c000833"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "irure dolor",
    "can_download_receipt": true,
    "amount_refunded": 58843414,
    "refunded": true,
    "refunds": [],
    "site_id": "4d44efb8-dea8-decf-f706-e5a9b20b6ef4",
    "billing_period_from": "1914-03-13",
    "billing_period_to": "1949-09-29",
    "processing_at": "1937-05-01T15:14:21.0Z",
    "created_at": "1944-01-08T12:47:47.0Z",
    "updated_at": "1928-09-19T02:09:44.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionProcessMembershipCharge

Manually process a charge for a membership

This endpoint allows a membership charge to be processed manually.

Path parameters

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/process
200
example response
{
  "data": {
    "id": "bdfc6b82-f49f-4dbb-8a8e-6de75f47ab00",
    "membership": {
      "id": "6d3aab2d-81a8-a9ca-dc03-252b0a19a942",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "99812471-b17b-fd9e-7b9a-e3510c7775c1",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69ab08ddc1cc92013c0002f0"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "consectetur",
    "can_download_receipt": true,
    "amount_refunded": 54678736,
    "refunded": false,
    "refunds": [
      {
        "id": "97be75e2-e116-7572-af4d-494ae1e8fdb2",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "24f7fea2-a700-3e1b-862b-9d60c8114c4d",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1936-05-25T10:30:32.0Z",
        "updated_at": "1932-01-18T23:52:54.0Z"
      }
    ],
    "site_id": "2a857fba-962c-2cc0-fa20-ba20d93ce90b",
    "billing_period_from": "1935-09-20",
    "billing_period_to": "1931-05-08",
    "processing_at": "1960-08-15T20:25:35.0Z",
    "created_at": "1948-04-02T03:19:52.0Z",
    "updated_at": "1968-08-20T14:56:43.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionRetryMembershipCharge

Manually retry a charge for a membership

This endpoint allows a membership charge to be retried manually.

Path parameters

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/retry
200
example response
{
  "data": {
    "id": "3f1fd53e-0ef6-f65d-28c5-4e6ea1d86048",
    "membership": {
      "id": "5f59b981-30b1-e6e8-f5f5-5d62a33a5be0",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "9f6a1d49-8276-87f5-644b-be3e64835b02",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69ab08ddc1cc92013c0002f1"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "nisi ad mollit",
    "can_download_receipt": false,
    "amount_refunded": -5548673,
    "refunded": true,
    "refunds": [
      {
        "id": "04e04e6c-03fe-d23c-fb63-875038d50d16",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "90f8236f-b519-1c94-c75e-350e9eba949f",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1961-03-08T06:04:28.0Z",
        "updated_at": "1902-06-15T18:28:48.0Z"
      },
      {
        "id": "7f853b04-e2e8-16cc-9e36-8cb31d2550b6",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "8652e86d-90f7-0d7c-b784-5f332b16dd91",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1940-04-16T17:07:06.0Z",
        "updated_at": "1896-02-02T07:25:24.0Z"
      },
      {
        "id": "9c69e1f7-478b-fceb-9164-9b87c9a45a86",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "026925af-f944-7cc2-db66-c29e394a0865",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1960-06-14T18:35:46.0Z",
        "updated_at": "1966-12-09T03:04:30.0Z"
      },
      {
        "id": "de251a35-d56d-b8cf-5702-aa24c26c5f99",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "a8290cb1-b2cd-83c0-0e96-6c742e6b3388",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1941-07-30T03:03:23.0Z",
        "updated_at": "1901-08-27T01:37:50.0Z"
      },
      {
        "id": "62b5f171-7f36-84fd-e99a-74d8143cf3f8",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e37b079e-4c9f-869c-7ff1-0ec4511aea5a",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1893-11-04T16:35:06.0Z",
        "updated_at": "1954-02-08T03:24:45.0Z"
      }
    ],
    "site_id": "7fa749cb-f47e-8b2c-58ec-263ba24bdde2",
    "billing_period_from": "1907-11-02",
    "billing_period_to": "1930-07-01",
    "processing_at": "1935-03-14T08:25:51.0Z",
    "created_at": "1893-08-06T11:07:43.0Z",
    "updated_at": "1890-08-11T05:19:51.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
createMembershipSms

Send an SMS message for a membership

This endpoint sends an SMS message to a membership's lead member. Currently supports sending billing details request messages.

Path parameters

Request body

  • message_type
    Required

    The type of message to send.

    Possible values are billing_details_request

  • If true, send the SMS even if the membership already has a payment method. Defaults to false.

Responses

  • 200

    The SMS message was successfully sent

  • 404

    The resource couldn't be found

  • 422

    The request didn't pass validation

POST/shop/memberships/{membershipId}/sms
200
example response
{
  "data": {
    "id": "69ab08dec1cc92013c000834",
    "organisation_id": "57e79021-6150-083f-e6e0-28bfb2212c19",
    "site_id": "0ebc2dc7-170a-a8af-734a-405b82a8a2eb",
    "customer_id": "c669f49e-1330-67e0-cb83-678c641c2da3",
    "membership_id": "92926e04-dec7-1006-603a-50229a003fbe",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "minim anim in nostrud ipsum",
    "message_type": "billing_details_request",
    "message_delivered": true,
    "created_at": "2024-02-02T12:01:01.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
422
example response
{
  "errors": {
    "labore8": [
      "in exercitation dolore",
      "Duis",
      "ex ut"
    ]
  },
  "message": "The request didn't pass validation"
}
createMembershipSmsPreview

Preview an SMS message for a membership

This endpoint previews an SMS message for a membership.

Path parameters

Request body

  • message_type
    Required

    The type of the SMS message.

    Possible values are billing_details_request

  • If true, preview the SMS even if the membership already has a payment method. Defaults to false.

Responses

  • 200

    The preview of the SMS message was successfully retrieved

  • 404

    The resource couldn't be found

POST/shop/memberships/{membershipId}/sms/preview
200
example response
{
  "data": {
    "message": "Your Premium Membership membership is almost ready! Please provide payment details for your membership payments. Set up here: https://example.com/confirm\n",
    "site_id": "0d56ea50-41f4-deac-190d-06d44dcd4eba",
    "organisation_id": "1bda5bbd-1909-a390-5565-19c2972e4abc"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}