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": "d39951b7-3a5a-46b6-85d6-b4ebd9d635e7",
      "attention_reason": "payment_disputed",
      "basket_id": "6998b1e468bd9801370000bd",
      "customer": {
        "id": "693b3a85-cce4-4da1-6633-5fe65ef77ca6",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1923-02-14",
        "brand_id": "ded3a09e-a107-acf8-651f-0e91be328c4a",
        "site_id": "c30f9f03-e151-0532-fbe9-5a7a13d70bfb",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "9a1d9762-481c-83d7-8e4a-b237e57cc380",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "1717a042-3c9b-d92f-deeb-86741c6b65b2",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "a95b8549-f17d-1047-465e-3a486634ff96",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1958-12-19T04:03:58.0Z",
        "created_at": "1932-10-09T18:07:17.0Z",
        "updated_at": "1963-04-06T12:10:47.0Z",
        "deleted_at": "1960-04-07T12:21:39.0Z",
        "last_active_at": "1935-09-15T21:47:28.0Z",
        "email_verified_at": "1968-07-17T12:55:15.0Z",
        "last_check_in": {
          "checked_in_at": "1936-05-24T10:35:52.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "31320022-fe46-98f2-2d80-5107009ddc73",
          "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": "aliqua labore"
      },
      "end_date": "1963-08-09T22:21:35.0Z",
      "external_ref": "nostrud dolore ad velit fugiat",
      "members": [
        {
          "customer_id": "d4dab057-fc68-2ad5-4bdc-1b4115949216",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1969-07-01T19:02:50.0Z",
      "next_charge": {
        "id": "2ac84627-99c6-0247-6223-1878c5b9ab08",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1936-09-03",
        "billing_period_to": "1954-06-29"
      },
      "payment_method": {
        "id": "consectetur irure",
        "type": "card",
        "last_4": "veniam qui consequat fugiat"
      },
      "rate": {
        "id": "22436453-65ff-4d3f-4376-a13a68583c4e",
        "membership_type_id": "564f6b7e-0dcb-76eb-a6df-d63d6512f410",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1912-05-02T06:38:10.0Z",
        "updated_at": "1945-07-02T03:59:31.0Z"
      },
      "site_id": "f8dc00c0-9dce-93a3-a607-ea66f5f3c3fb",
      "source": "import",
      "start_date": "1959-04-10T01:59:14.0Z",
      "status": "active",
      "status_updated_at": "1903-12-01T13:36:17.0Z",
      "type": {
        "id": "bbc1f421-e2f1-9f3c-6bf5-3208afd2f22d",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "officia aute esse amet cupidatat",
        "brand_id": "fe605b4f-ecc3-85b3-8c42-52af250703fb",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1947-03-15T04:36:26.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "57c791f8-9491-2639-7d27-e86aa0c4fefc",
            "membership_type_id": "3e8e7944-2da8-be56-2159-a65c6c70bb39",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "fugiat",
              "est dolore aliqua dolore esse"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1916-02-20T10:08:13.0Z",
            "updated_at": "1918-03-01T20:44:42.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1899-11-28T23:56:38.0Z",
        "updated_at": "1925-03-14T03:52:31.0Z",
        "deleted_at": "1940-07-12T14:28:01.0Z"
      },
      "payment_details_url": "non aliqua",
      "created_at": "1965-07-27T05:47:06.0Z"
    },
    {
      "id": "74efc65b-fcf8-f0d4-0044-7ddbd7bfd7ed",
      "attention_reason": "payment_failed",
      "basket_id": "6998b1e468bd9801370000be",
      "customer": {
        "id": "ad3ea21f-81a5-06c8-1cef-d3608e35a4cf",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1891-10-04",
        "brand_id": "1c5b8efe-9451-1447-0cd6-ba35bb07efcf",
        "site_id": "53c2dffd-f240-4c54-dd9a-a29a0332499a",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "5beba7ca-c4a0-3ee6-b253-2fdf6461126b",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "4fc3ed91-d443-ff4a-9992-43ef5489606e",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "70dfec80-d9e3-11f0-8bae-38dc0abd198e",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1907-03-31T13:44:41.0Z",
        "created_at": "1945-03-25T01:38:29.0Z",
        "updated_at": "1968-12-26T06:40:22.0Z",
        "deleted_at": "1969-11-24T15:32:32.0Z",
        "last_active_at": "1935-11-05T22:50:59.0Z",
        "email_verified_at": "1911-05-07T13:46:04.0Z",
        "last_check_in": {
          "checked_in_at": "1956-08-19T17:35:35.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "b8a321e9-3909-3954-e291-b717c39d09b6",
          "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": "id irure"
      },
      "end_date": "1898-08-13T10:41:56.0Z",
      "external_ref": "non adipisicing dolore sit",
      "members": [
        {
          "customer_id": "5d481ed1-ad8b-97b4-cb09-92d2c490bc51",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "d3f2d434-6fa4-8771-c538-b7161843fe32",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "0ab38556-322c-73a1-807f-4f74c39c4237",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "1aeaca4d-41b7-bd0a-119d-7f7c49d72b88",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "b0d9cfe5-2a44-0a8b-96a9-fc19843a815d",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1969-07-17T16:34:44.0Z",
      "next_charge": {
        "id": "d1b764fb-5ccd-c044-8db1-bccafe56b566",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1934-06-13",
        "billing_period_to": "1964-02-04"
      },
      "payment_method": {
        "id": "Duis ipsum non id",
        "type": "card",
        "last_4": "dolore nisi",
        "status": "revoked"
      },
      "rate": {
        "id": "3eeaf14e-9bcd-83df-de46-0fb39fd8bb23",
        "membership_type_id": "3c5521bd-f50f-52a2-c1e1-9832eb4d0b21",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "eiusmod officia non",
          "veniam consectetur anim ut ad",
          "ut",
          "qui",
          "officia occaecat nisi proident"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1890-01-21T04:14:09.0Z",
        "updated_at": "1895-06-30T11:23:21.0Z"
      },
      "site_id": "c7f477ec-0240-db22-9abd-63602eb798ab",
      "source": "unknown",
      "start_date": "1958-03-25T03:05:08.0Z",
      "status": "active",
      "status_updated_at": "1920-04-08T11:42:07.0Z",
      "type": {
        "id": "049f39cc-dd9e-cdf7-cf84-23c5cf62099a",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "velit in anim Duis",
        "brand_id": "f44c2030-c2d1-5b66-7908-5be6877104ca",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1956-10-17T14:50:51.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "b5efd91a-7c18-a300-d2f5-7b522482d5e9",
            "membership_type_id": "b5084532-4fab-6d3b-4974-ff065bef07ae",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ex"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1897-02-18T14:02:43.0Z",
            "updated_at": "1934-04-02T23:34:28.0Z"
          },
          {
            "id": "ea07db7a-4e03-aca4-6b33-aa367aa2a424",
            "membership_type_id": "cdaad843-e391-3bb5-ac2f-3ae3874af5f2",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "Lorem in",
              "id",
              "ex incididunt ullamco",
              "ut in quis non ullamco"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1926-04-30T04:34:07.0Z",
            "updated_at": "1967-08-19T11:11:19.0Z"
          },
          {
            "id": "09f1f852-7e5f-e522-2080-ccff3f23d6b6",
            "membership_type_id": "0dcca20c-ded9-0e1f-11bc-78582e799be7",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1898-09-10T04:31:22.0Z",
            "updated_at": "1920-08-27T17:01:46.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1945-07-17T15:54:54.0Z",
        "updated_at": "1942-06-21T14:01:44.0Z",
        "deleted_at": "1943-01-26T17:01:17.0Z"
      },
      "payment_details_url": "deserunt fugiat qui non ipsum",
      "created_at": "1931-06-22T06:28:52.0Z"
    },
    {
      "id": "3a911a23-379e-088d-d8ca-a19664474bf9",
      "attention_reason": "mandate_revoked",
      "basket_id": "6998b1e468bd9801370000bf",
      "customer": {
        "id": "1ddb2ebf-86b6-dd80-4fc7-aa835bf073ff",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1937-06-21",
        "brand_id": "ca8ba7b3-941b-fdf6-0042-16fcbd3c9ec8",
        "site_id": "b2493d2b-6000-ff90-2f99-0b6afee3af13",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "23aa10c1-7e64-2fd8-60f1-9d232390968b",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "5e55038d-17f5-0d22-7859-17fc9d0a84d1",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "5d1349da-7632-d401-f5fc-c9a00cc396ab",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1923-03-29T05:56:36.0Z",
        "created_at": "1911-12-02T22:26:43.0Z",
        "updated_at": "1957-08-25T21:19:19.0Z",
        "deleted_at": "1925-06-06T20:53:55.0Z",
        "last_active_at": "1913-01-14T13:28:37.0Z",
        "email_verified_at": "1942-10-07T09:01:43.0Z",
        "last_check_in": {
          "checked_in_at": "1915-11-23T19:18:22.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "edb5d2ca-9109-26b1-0e11-97065ebe4e45",
          "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": "dolore"
      },
      "end_date": "1965-11-03T06:29:34.0Z",
      "external_ref": "officia laboris in labore eiusmod",
      "members": [
        {
          "customer_id": "6d35935e-ed3f-531d-f794-4c02570a349f",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "f4f0275a-adbc-dabc-4f70-d0568c149646",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "49f53131-fdf6-424c-4088-f7b17ced9e1c",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "c9db28d6-0b14-bcc3-277d-3621bcff27f4",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1943-11-16T18:52:39.0Z",
      "next_charge": {
        "id": "894952d9-42be-1d48-1dd1-ede34b7665a1",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1965-05-18",
        "billing_period_to": "1923-03-02"
      },
      "payment_method": {
        "id": "enim amet deserunt",
        "type": "card",
        "last_4": "esse fugiat id officia ea",
        "status": "revoked"
      },
      "rate": {
        "id": "01127d97-5d53-1cc1-abcf-1e3f621c10cb",
        "membership_type_id": "45bbcf84-599a-8f6e-78a5-779aa56ae594",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "sed magna commodo sit sint",
          "exercitation reprehenderit sunt",
          "non enim ullamco",
          "nostrud",
          "in est laborum et"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1933-02-02T02:20:46.0Z",
        "updated_at": "1964-07-24T22:46:26.0Z"
      },
      "site_id": "e11d24eb-7626-9a64-8158-35d6b827c206",
      "source": "self_signup",
      "start_date": "1902-01-06T07:50:45.0Z",
      "status": "inactive",
      "status_updated_at": "1898-02-02T06:41:12.0Z",
      "type": {
        "id": "64db9dfb-b2e8-119e-6e3a-532bbb83db31",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "aliqua velit",
        "brand_id": "5100c220-cc1a-378b-b052-e1b3e277b0b7",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "link_only",
        "minimum_start_date": "1931-06-24T06:38:56.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1943-08-05T17:17:56.0Z",
        "updated_at": "1899-10-12T23:24:16.0Z",
        "deleted_at": "1928-10-26T06:12:32.0Z"
      },
      "payment_details_url": "qui et Lorem deserunt",
      "created_at": "1967-02-14T20:50:06.0Z"
    },
    {
      "id": "74ccf40d-6a31-8546-a404-184147795974",
      "attention_reason": "no_mandate",
      "basket_id": "6998b1e468bd9801370000c0",
      "end_date": "1922-11-27T20:49:48.0Z",
      "external_ref": "ut fugiat Lorem incididunt ea",
      "members": [
        {
          "customer_id": "5f19f354-2f47-be75-671b-5d87fb136e61",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "08a85275-84d2-7b27-8ee1-1fe0010cc764",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1967-04-08T14:43:33.0Z",
      "payment_method": {
        "id": "proident et velit laboris",
        "type": "card",
        "card_brand": "amex"
      },
      "rate": {
        "id": "2fc6862e-36ee-bbc2-f785-a8bfa9c4d863",
        "membership_type_id": "9641db54-0ca4-1cf5-3a44-9b5c78bf4394",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "ullamco incididunt est do",
          "sit",
          "esse in minim",
          "exercitation tempor ut dolor",
          "eiusmod veniam Lorem aute nulla"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1923-10-31T13:58:46.0Z",
        "updated_at": "1929-01-23T07:35:02.0Z"
      },
      "site_id": "7efd510c-8227-e9a6-9b2b-f9a5e0951967",
      "source": "self_signup",
      "start_date": "1950-03-30T12:28:19.0Z",
      "status": "needs_attention",
      "status_updated_at": "1898-07-31T13:02:42.0Z",
      "type": {
        "id": "6dfa9b72-3176-9c04-47e6-b2546aca0c1e",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "Excepteur nisi",
        "brand_id": "15ec1acd-4a61-e5ad-ba41-2b073fc7a973",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1918-02-18T15:55:22.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "2b71cf6a-ff59-67e9-6302-9197dc9a38ad",
            "membership_type_id": "dfba323f-2b09-2107-1973-400073892769",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "mollit quis magna Duis",
              "mollit sed Lorem sunt",
              "aliquip veniam Ut pariatur eiusmod"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1911-01-16T02:27:14.0Z",
            "updated_at": "1937-11-09T15:23:23.0Z"
          },
          {
            "id": "20e47aa6-ddcd-b48e-1714-e00decc6433d",
            "membership_type_id": "74bd7baf-f9cc-0574-0e96-a6bf7f08ebb3",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "consequat sit do",
              "nostrud labore ea",
              "ullamco",
              "cupidatat",
              "consequat dolore in deserunt cupidatat"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1966-07-06T17:07:24.0Z",
            "updated_at": "1955-05-19T14:09:12.0Z"
          },
          {
            "id": "67def590-474b-d676-0200-ee5543beb79c",
            "membership_type_id": "b78c8c91-0cf8-cd84-3548-32aaba6f3410",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "labore aute anim",
              "ullamco",
              "ut labore enim laborum eu",
              "pariatur Ut fugiat",
              "reprehenderit id laborum"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1939-05-12T13:38:05.0Z",
            "updated_at": "1909-08-28T09:27:36.0Z"
          },
          {
            "id": "8393b71a-e8ff-beb5-6f74-8244b8b28d1f",
            "membership_type_id": "4c2dc4ab-fe5f-645d-593b-0626a21f57f6",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "cillum",
              "ut deserunt",
              "ullamco sed laboris",
              "consequat",
              "ullamco"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1938-04-16T20:13:54.0Z",
            "updated_at": "1953-12-21T01:39:01.0Z"
          },
          {
            "id": "1e2b8f28-00e1-6c17-833c-9bec805b1ed1",
            "membership_type_id": "08d71878-a57c-d3ae-f2eb-029d4b09de09",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in Ut",
              "quis laboris"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1898-07-22T05:12:58.0Z",
            "updated_at": "1963-08-13T10:42:27.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1960-06-06T09:48:38.0Z",
        "updated_at": "1933-05-31T18:44:53.0Z",
        "deleted_at": "1900-10-22T04:55:29.0Z"
      },
      "created_at": "1896-07-01T18:04:33.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": "8c09ef16-6432-c50a-d473-0391ba5401e6",
    "attention_reason": "mandate_revoked",
    "basket_id": "6998b1e468bd9801370000c1",
    "customer": {
      "id": "78652e22-e59d-be93-7229-2b21ad2395bf",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1968-02-08",
      "brand_id": "386a5e7f-722e-adc7-60b6-6e5a4b2ef478",
      "site_id": "cdd9b548-0685-b6d9-4e9e-44c1f775a63f",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "b0fb2b7d-edde-9e54-572e-fe3da0dd5836",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "fb1d0d38-c6c4-fbbf-6e12-1449cda23265",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "cae8588f-22a5-f9ae-36bb-11fd78f5a68a",
          "value": "VIP",
          "colour": "ff6634"
        },
        {
          "id": "cc628be1-4a87-3527-8b80-44f7bed2eb14",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1930-07-25T06:39:01.0Z",
      "created_at": "1962-06-22T11:29:30.0Z",
      "updated_at": "1926-05-17T09:11:40.0Z",
      "deleted_at": "1915-09-03T23:48:43.0Z",
      "last_active_at": "1958-03-18T05:49:57.0Z",
      "email_verified_at": "1893-06-15T01:29:42.0Z",
      "last_check_in": {
        "checked_in_at": "1930-01-18T11:36:38.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "d6861090-e5b4-b5a6-adc0-54d2be593ac7",
        "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": "id deserunt"
    },
    "end_date": "1907-09-08T17:01:43.0Z",
    "external_ref": "labore proident commodo ut culpa",
    "members": [
      {
        "customer_id": "651db91f-fc54-a5e9-dc01-ad69945a157d",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "74c8aaac-cf7e-8755-2d59-46c75a50a9f5",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "58f26f6a-45ae-c484-2aa5-1898d3d06f9f",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "978677ec-8a23-73ca-2df1-aa133fea4c84",
        "is_lead": false,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1916-03-18T18:52:01.0Z",
    "next_charge": {
      "id": "e625c670-51d0-3d0d-7cd5-64011ca91b66",
      "amount": 3995,
      "currency": "GBP",
      "status": "failed",
      "billing_period_from": "1964-01-31",
      "billing_period_to": "1942-03-13"
    },
    "payment_method": {
      "id": "eu ad laboris in et",
      "type": "card",
      "last_4": "in",
      "status": "revoked",
      "card_brand": "amex"
    },
    "rate": {
      "id": "7613ba14-47af-1dae-2a07-3b3a92720b59",
      "membership_type_id": "8864331c-66ce-d20d-6e2d-35813a46ac2b",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1967-05-08T01:39:33.0Z",
      "updated_at": "1950-02-27T07:47:38.0Z"
    },
    "site_id": "0e2d754b-51e7-dcb6-2666-5deb89be27ed",
    "source": "unknown",
    "start_date": "1900-02-16T10:55:06.0Z",
    "status": "needs_dd_mandate",
    "status_updated_at": "1953-08-17T03:19:52.0Z",
    "type": {
      "id": "e04b5e7f-2632-d3c4-d881-0b8e13d94fd2",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "adipisicing id ad ullamco et",
      "brand_id": "47b6938d-86e2-33e2-6905-9a43cb91da56",
      "offline_payments": false,
      "disable_confirmation_email": true,
      "private": false,
      "visibility": "public",
      "minimum_start_date": "1893-10-15T11:23:34.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "ca6eb626-864f-2cb7-8b90-2fd4ab9a23b5",
          "membership_type_id": "ee946539-026d-7518-0233-2c373ab042bf",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1954-02-10T02:07:39.0Z",
          "updated_at": "1957-06-24T13:19:38.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1899-12-07T13:25:30.0Z",
      "updated_at": "1953-11-05T10:59:16.0Z",
      "deleted_at": "1905-04-08T11:56:54.0Z"
    },
    "payment_details_url": "ipsum amet reprehenderit",
    "created_at": "1898-10-17T22:06:43.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": "e6486b75-a956-59ba-c4f2-696f6fb9cf25",
    "membership": {
      "id": "1fe7d90f-19ac-32b5-ddb2-7acb55c9bdad",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "3a7452e3-fad6-0170-e689-b98b3d813176",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "elit dolore",
    "can_download_receipt": true,
    "amount_refunded": 35049128,
    "refunded": false,
    "refunds": [
      {
        "id": "28d2cfaf-7195-b9ad-eb52-5d6e9bf9cb9b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "9074280c-050f-e5c5-f4eb-9be7e7232551",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1893-10-09T16:22:34.0Z",
        "updated_at": "1937-07-03T14:08:16.0Z"
      },
      {
        "id": "5dd9d572-ac3b-4355-34fb-875de999755e",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "34062afe-9155-39fd-4b8c-336c59c3b57c",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1895-08-28T17:49:19.0Z",
        "updated_at": "1924-01-19T22:10:56.0Z"
      }
    ],
    "site_id": "07ca503a-c76b-ef27-3fac-32a0d0e7a346",
    "billing_period_from": "1907-03-14",
    "billing_period_to": "1922-03-16",
    "processing_at": "1960-01-23T01:16:55.0Z",
    "created_at": "1936-06-30T08:35:18.0Z",
    "updated_at": "1936-07-16T03:36:35.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": "d6b27f6a-4222-102f-fcda-cb5563fae9bf",
    "membership": {
      "id": "e850c078-5914-0abe-cfd5-c0ebca49d014",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "f8d1ca6d-c12c-7db2-e945-12d7ad929349",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "sit consequat nisi",
    "can_download_receipt": false,
    "amount_refunded": -88447702,
    "refunded": true,
    "refunds": [
      {
        "id": "9fada84b-068c-2e19-2207-a65b49f4fc94",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "6872f519-b027-76ce-90b7-fbaf8ccf8be0",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1969-01-11T09:47:10.0Z",
        "updated_at": "1929-10-09T18:11:33.0Z"
      },
      {
        "id": "fae1b4d6-fd35-e95a-5131-b8a7d9a26415",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "5f7c34d3-ef1e-16c0-08dd-018c16cd7661",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1897-09-15T09:50:04.0Z",
        "updated_at": "1893-06-08T01:01:27.0Z"
      },
      {
        "id": "28672cdf-6b18-a523-26ac-fac253d82442",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "04a39c30-45f8-acb2-8b5c-c221265ec6cc",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1912-08-31T20:49:24.0Z",
        "updated_at": "1918-09-20T05:55:41.0Z"
      }
    ],
    "site_id": "25df7e3c-91c7-c8ba-83a4-be9d041d885c",
    "billing_period_from": "1964-10-03",
    "billing_period_to": "1950-10-12",
    "processing_at": "1960-12-10T07:27:54.0Z",
    "created_at": "1952-09-19T07:17:02.0Z",
    "updated_at": "1947-12-22T22:10:01.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": "92627a36-1183-bd24-9766-0aa9debf7102",
    "membership": {
      "id": "e16e2766-07c7-7a03-c198-c23dba253bd8",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "3f031a0e-da86-323f-18ef-8efd9636e7e8"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "reprehenderit minim",
    "can_download_receipt": false,
    "amount_refunded": -19378006,
    "refunded": true,
    "refunds": [
      {
        "id": "09f05c8f-66a8-3d32-d80b-5e2c00a860fa",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "067f1b57-1c7b-c0e3-6cce-3c0d18d4a499",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1954-05-16T17:58:22.0Z",
        "updated_at": "1916-01-02T10:06:41.0Z"
      },
      {
        "id": "3df239bb-72cb-53b7-0fbc-d28de53c58f5",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "aa48e25b-ed28-bd89-9cef-d1ce2b336d58",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1941-12-19T10:33:55.0Z",
        "updated_at": "1958-04-19T23:29:48.0Z"
      },
      {
        "id": "edd391b3-65f2-6d83-d6c8-c30afdade49b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "d3ad2858-9e7d-3daf-3cf3-10604643fd57",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1907-05-14T21:06:04.0Z",
        "updated_at": "1941-11-06T15:01:09.0Z"
      },
      {
        "id": "5c45e9eb-6d2e-e7ac-d281-475e2c77971a",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1922-01-25T06:24:14.0Z",
        "updated_at": "1932-04-27T19:37:23.0Z"
      },
      {
        "id": "33ece3b4-eb88-d0b1-27ac-2d4a12c3e9e4",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "04b725fa-0a43-15c7-36a1-ae87de4e995c",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1904-10-08T09:52:36.0Z",
        "updated_at": "1958-01-24T20:51:23.0Z"
      }
    ],
    "site_id": "10d03c77-21bb-5128-aaff-ff2d3a4ebbeb",
    "billing_period_from": "1928-06-29",
    "billing_period_to": "1907-04-15",
    "processing_at": "1965-10-07T18:40:36.0Z",
    "created_at": "1960-06-24T13:22:05.0Z",
    "updated_at": "1912-01-04T22:01:19.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": "6998b1e468bd9801370000c2",
    "organisation_id": "2aa2337b-fd49-dba3-f199-d3aeafd3c189",
    "site_id": "1f4893f8-3fb6-8e15-8446-777a95e58de5",
    "customer_id": "b1eb41d7-7f28-eaaa-9240-b17072a66518",
    "membership_id": "cca02a8d-d575-521c-bde3-6a7483edabcb",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "minim id in enim est",
    "message_type": "billing_details_request",
    "message_delivered": true,
    "created_at": "2024-02-02T12:01:01.0Z",
    "sent_at": "2024-02-02T12:01:01.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
422
example response
{
  "errors": {
    "nisi_b36": [
      "ea"
    ]
  },
  "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": "53c780c6-f008-a87b-8873-92c294e91f11",
    "organisation_id": "4b7c6531-fa30-f7e4-a612-c6089041b562"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}