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": "9385d3d7-76ad-3693-ed0e-c3ad013d6533",
      "attention_reason": "setup_unpaid",
      "basket_id": "69f1e78a92b75201480000ab",
      "customer": {
        "id": "67a64a5b-b89b-fb09-00f4-e2599bf356c9",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1958-08-16",
        "brand_id": "65676537-3436-5974-d7f5-8586a3d22d07",
        "site_id": "1aa4148f-3e47-42de-5858-145b62297435",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "106d4c93-800f-411a-f1ef-c4f220912de9",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "71602a1d-8ce3-42fd-f46d-c68386afaa4c",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "936f22af-65c8-d901-edc8-2fdb054ddf4e",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1898-02-16T14:57:31.0Z",
        "created_at": "1896-10-18T19:09:42.0Z",
        "updated_at": "1928-12-03T09:30:27.0Z",
        "deleted_at": "1933-07-04T15:06:45.0Z",
        "last_active_at": "1908-01-24T03:48:45.0Z",
        "email_verified_at": "1937-03-20T15:20:52.0Z",
        "last_check_in": {
          "checked_in_at": "1929-05-10T04:59:45.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "050d797d-c4d3-eb6f-5b5d-16b059f64f69",
          "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": "incididunt consectetur aliquip"
      },
      "end_date": "1953-07-05T02:49:56.0Z",
      "external_ref": "amet labore commodo eu",
      "members": [
        {
          "customer_id": "1246d0c8-93ec-21ef-6ae0-29c5a8b3bd89",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "9c808dc6-6d2f-6417-284a-36893ec48f97",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1942-12-23T22:34:59.0Z",
      "next_charge": {
        "id": "f6b7e8b2-3f0b-e3bd-2e09-26ca03672d32",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1942-04-30",
        "billing_period_to": "1898-10-29"
      },
      "payment_method": {},
      "rate": {
        "id": "e88328cf-af71-d960-1442-c59151b0ccbd",
        "membership_type_id": "0a7770e8-75ea-6a9d-2983-d0f51938d285",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "Ut dolore nostrud"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1960-06-12T22:08:36.0Z",
        "updated_at": "1941-10-26T21:01:19.0Z"
      },
      "site_id": "1a68d41f-5955-a77a-7566-536351952f3d",
      "source": "import",
      "start_date": "1929-10-19T06:18:12.0Z",
      "status": "expired",
      "status_updated_at": "1923-03-23T06:21:06.0Z",
      "type": {
        "id": "8a84c1ab-6685-d138-1519-d2879049014f",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "commodo ad",
        "brand_id": "f001772b-8acd-f990-5fcb-6ae0ef64545b",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1959-11-26T14:43:39.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "2c7bfd02-a60a-4d86-af44-deab2fff2b6d",
            "membership_type_id": "138d578f-e723-92ff-e886-3392a6d603e6",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "dolore ea consectetur enim laboris",
              "nisi est fugiat"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1904-07-01T20:09:05.0Z",
            "updated_at": "1906-09-05T14:32:35.0Z"
          },
          {
            "id": "4242ca67-e8b3-9194-0dbd-b99dfce07945",
            "membership_type_id": "b192b5e3-b048-14b0-30ca-878a50ed3431",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "laborum elit cillum aliquip enim",
              "ea reprehenderit cupidatat",
              "adipisicing",
              "cupidatat anim tempor sed consequat",
              "adipisicing Lorem reprehenderit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1928-03-06T20:18:23.0Z",
            "updated_at": "1968-04-24T14:43:53.0Z"
          },
          {
            "id": "d8b021e6-ab27-4f4a-f486-913c8f5ec5b2",
            "membership_type_id": "bb14bdc7-3129-cd45-ede0-4e97542eb9b3",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "dolore dolor officia esse",
              "Excepteur pariatur exercitation reprehenderit",
              "sed",
              "irure non",
              "minim mollit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1896-10-06T11:22:34.0Z",
            "updated_at": "1949-04-14T16:12:49.0Z"
          },
          {
            "id": "58247508-77d8-e92c-5b8b-035a247590b5",
            "membership_type_id": "bc1a7952-c309-2ff9-9030-1b9707afb09e",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "veniam minim in officia eu",
              "velit sit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1964-05-07T02:24:06.0Z",
            "updated_at": "1959-12-20T14:42:04.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1935-05-17T18:18:06.0Z",
        "updated_at": "1936-05-14T13:19:56.0Z",
        "deleted_at": "1916-04-28T19:25:10.0Z"
      },
      "payment_details_url": "incididunt tempor",
      "created_at": "1901-04-06T12:07:08.0Z"
    },
    {
      "id": "77096538-1b54-3f2b-f1af-f66c717b6210",
      "attention_reason": "payment_failed",
      "basket_id": "69f1e78a92b75201480000ac",
      "customer": {
        "id": "195f7311-fd71-b924-8892-e10349762861",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1965-12-02",
        "brand_id": "c3ab11c8-87a0-9c16-9220-023e3ae485d9",
        "site_id": "0ae7c34f-9c11-77d6-a884-cb4d23de0566",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "7d5b4e58-b3cc-6e4a-cf6e-27b854cb1f7d",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "b406428d-5e43-7cdd-6a7a-b2b25cf0ae98",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1894-04-01T11:32:06.0Z",
        "created_at": "1923-08-19T12:14:37.0Z",
        "updated_at": "1894-11-14T15:48:46.0Z",
        "deleted_at": "1938-01-26T14:48:14.0Z",
        "last_active_at": "1943-10-23T07:12:48.0Z",
        "email_verified_at": "1901-04-12T22:05:03.0Z",
        "last_check_in": {
          "checked_in_at": "1904-10-19T05:16:40.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "c2675d58-1207-75e8-2187-1346f4ddd5ea",
          "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": "quis est"
      },
      "end_date": "1896-05-01T05:05:30.0Z",
      "external_ref": "amet Lorem do",
      "members": [
        {
          "customer_id": "edc3d47a-4737-a7ae-00f8-3bfa46a01b92",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "a4cbf06b-71b2-2f32-ff19-a6b52728c633",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "d4df2b35-e7d5-e5aa-b3cc-2a5b020dbc33",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1969-04-20T03:36:05.0Z",
      "next_charge": {
        "id": "9f959d0d-8903-9e40-3ccc-62271ad18b75",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1952-12-31",
        "billing_period_to": "1961-07-01"
      },
      "payment_method": {
        "id": "Excepteur",
        "type": "card",
        "last_4": "fugiat",
        "status": "revoked"
      },
      "rate": {
        "id": "1c366ee8-daf5-0266-38d4-d5ef38d283af",
        "membership_type_id": "14c550c3-53ea-f9ab-9d74-6b3e4ebeb7a8",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "ullamco",
          "Ut voluptate consequat culpa qui",
          "est dolore veniam",
          "exercitation anim ad",
          "do officia Lorem"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1907-04-08T06:48:45.0Z",
        "updated_at": "1968-07-24T16:23:27.0Z"
      },
      "site_id": "80c86212-1e39-7b47-6943-7c0d38bc323c",
      "source": "app",
      "start_date": "1961-04-23T18:36:22.0Z",
      "status": "inactive",
      "status_updated_at": "1891-06-02T19:41:41.0Z",
      "type": {
        "id": "8a7f0547-b972-8f35-4666-fa0d6d8fd4b0",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "tempor reprehenderit velit",
        "brand_id": "d1521235-c892-167c-22c6-a02449333322",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1951-07-06T01:13:59.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "7a95578f-f942-2360-5071-b004a71309b9",
            "membership_type_id": "fc803269-4913-1490-0a84-44e13420449a",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "culpa qui",
              "sit dolore eiusmod laboris"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1945-06-30T23:24:15.0Z",
            "updated_at": "1942-06-17T12:26:41.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1896-05-12T10:01:29.0Z",
        "updated_at": "1904-07-11T12:20:04.0Z",
        "deleted_at": "1931-12-06T11:38:35.0Z"
      },
      "payment_details_url": "adipisicing sit exercitation",
      "created_at": "1919-05-16T18:09:25.0Z"
    },
    {
      "id": "9779c1ce-7d24-6ffb-71a4-7d8e52fcdc02",
      "attention_reason": "no_mandate",
      "basket_id": "69f1e78a92b75201480000ad",
      "customer": {
        "id": "b36c18df-a4dd-aba4-ac00-a4a81d1edaf2",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1893-10-14",
        "brand_id": "b04392af-d434-2b54-ab43-e4013e3aca5c",
        "site_id": "2f9005e2-110f-c6a0-0f95-394d6c7fd736",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "c98e46a8-cccc-41e5-9b90-491a21bead05",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "c974482e-da60-8e43-2cfa-d4ca5dd1864a",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "00125f57-c069-1686-5413-ee1882d65f28",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "cf858fb0-9ca3-9d27-fea7-55af3355341d",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1928-06-03T15:55:13.0Z",
        "created_at": "1954-03-13T01:20:14.0Z",
        "updated_at": "1957-12-02T21:04:52.0Z",
        "deleted_at": "1969-12-25T14:25:19.0Z",
        "last_active_at": "1958-08-29T19:48:22.0Z",
        "email_verified_at": "1939-09-21T07:05:48.0Z",
        "last_check_in": {
          "checked_in_at": "1938-04-01T18:50:56.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "5ae80cce-4cdc-e5bd-cc33-6994748f7fe7",
          "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 fugiat quis do sed"
      },
      "end_date": "1931-03-10T12:45:34.0Z",
      "external_ref": "ut labore",
      "members": [
        {
          "customer_id": "3cd0b94d-a51a-f9a3-54a8-7701796118dd",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "2444f9a9-8bfc-8717-fa8e-671cc161913d",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "6f5156a5-3e4d-076c-8733-8b8560f01485",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "ac37eeca-1835-0a6e-df0f-3e2d53a0f802",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1931-04-01T16:14:56.0Z",
      "payment_method": {
        "id": "Excepteur",
        "type": "card",
        "last_4": "sint fugiat reprehenderit id",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "cc799855-f3fc-1549-208b-98f98188e550",
        "membership_type_id": "b4190556-7cba-ff63-b441-8130fff0bdaa",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "pariatur ea in deserunt officia",
          "dolor deserunt laboris non",
          "aliqua adipisicing",
          "fugiat deserunt"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1929-05-04T11:01:19.0Z",
        "updated_at": "1924-02-21T10:10:08.0Z"
      },
      "site_id": "dcaa40b8-3575-e1ce-341e-547ee12536fe",
      "source": "unknown",
      "start_date": "1968-03-26T11:42:05.0Z",
      "status": "needs_attention",
      "status_updated_at": "1896-07-07T08:30:05.0Z",
      "type": {
        "id": "fd0b8ab3-2999-ebbf-4067-3377dfe75724",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "aliquip irure in eiusmod ea",
        "brand_id": "44933c53-3a33-a0f5-766a-fe2f1ce17a12",
        "offline_payments": true,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1935-04-18T20:45:08.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "5d8af775-88b0-f102-9be9-90da3fdc558b",
            "membership_type_id": "d2078d73-db8b-2dbf-6168-9b29297858bd",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sit sunt esse in",
              "consequat exercitation Ut consectetur in",
              "ea deserunt nostrud",
              "dolore non adipisicing est",
              "irure reprehenderit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1954-06-01T14:59:28.0Z",
            "updated_at": "1905-01-22T19:45:58.0Z"
          },
          {
            "id": "2799e492-b0c2-fb6d-45f1-e6026933bbd0",
            "membership_type_id": "4d7a6dd7-77b5-232f-33d1-82f2b67896de",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in in ad nostrud culpa",
              "quis aliqua"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1959-08-26T21:23:44.0Z",
            "updated_at": "1948-01-15T16:54:48.0Z"
          },
          {
            "id": "8bf3bc39-4030-2348-3951-6ea8f84aaf12",
            "membership_type_id": "343f7bab-5ded-d536-2b2e-3f6692deccc3",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "in dolore",
              "ullamco amet deserunt proident"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1958-03-03T20:50:55.0Z",
            "updated_at": "1904-02-24T17:19:35.0Z"
          },
          {
            "id": "cd415a4d-8fef-a70c-4d51-c83cd316ec43",
            "membership_type_id": "37f8aad3-9043-8c50-3ef1-4b80f56ae80b",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "et",
              "in Lorem voluptate",
              "reprehenderit incididunt"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1931-08-11T04:01:26.0Z",
            "updated_at": "1952-01-23T08:44:29.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1911-09-15T11:49:42.0Z",
        "updated_at": "1956-01-03T01:55:49.0Z",
        "deleted_at": "1912-03-28T12:41:29.0Z"
      },
      "created_at": "1929-12-03T19:01:29.0Z"
    },
    {
      "id": "17ab3f89-b14e-ed37-f841-2266f0d2d832",
      "attention_reason": "payment_failed",
      "basket_id": "69f1e78a92b75201480000ae",
      "customer": {
        "id": "688eedf9-79e3-259a-2e7f-121ac94fdbb7",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1964-03-04",
        "brand_id": "aafdb899-ae29-a7cf-cf8f-18f17efb7910",
        "site_id": "438dc400-625b-56a6-be3e-a007af308fa4",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "722d965a-ae97-ebe4-8430-9f180f460ac1",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "02ae8f3b-0c6f-98f3-1801-346d4e66e9c3",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "f72ef3b6-561a-8e9a-092c-a7a57510bfc3",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1944-05-20T13:10:54.0Z",
        "created_at": "1936-06-26T09:16:46.0Z",
        "updated_at": "1907-03-31T17:13:49.0Z",
        "deleted_at": "1899-07-30T01:11:28.0Z",
        "last_active_at": "1954-02-24T02:35:10.0Z",
        "email_verified_at": "1916-12-28T01:39:46.0Z",
        "last_check_in": {
          "checked_in_at": "1891-05-09T19:58:17.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "7de543c6-17ca-6854-be3a-84c3de3c0d74",
          "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": "irure consectetur"
      },
      "end_date": "1921-08-20T10:18:49.0Z",
      "external_ref": "Ut laboris",
      "members": [
        {
          "customer_id": "e3abdab0-d0b9-dcef-1c5f-6c4ef3085e54",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "be2fac8f-4ac1-10c2-d72a-84d779b5946c",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "c6ce88cd-1b3c-fffb-a664-cdceb9612cd0",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "06665a1e-f848-c24b-de02-9a01c1e11b3b",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "07f1be07-efa9-001c-107e-b759f5269923",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1947-02-22T14:33:06.0Z",
      "next_charge": {
        "id": "2b9ac518-3bbf-65be-8d9f-ca8755cdc93f",
        "amount": 3995,
        "currency": "GBP",
        "status": "failed",
        "billing_period_from": "1917-12-02",
        "billing_period_to": "1966-05-19"
      },
      "payment_method": {
        "last_4": "esse qui adipisicing consectetur quis",
        "card_brand": "amex"
      },
      "rate": {
        "id": "25843fe2-ae8e-27f2-a028-d7950e32c8a4",
        "membership_type_id": "d0613190-529a-1302-a16e-69610e150dbb",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "sed anim",
          "enim",
          "nostrud ut",
          "ipsum in",
          "voluptate"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1900-02-12T21:07:19.0Z",
        "updated_at": "1967-03-08T18:40:23.0Z"
      },
      "site_id": "1caba121-d6d9-6f41-8792-61072b65a00d",
      "source": "unknown",
      "start_date": "1965-05-30T05:58:13.0Z",
      "status": "active",
      "status_updated_at": "1942-07-28T14:10:21.0Z",
      "type": {
        "id": "d3a3a328-62a6-c1e7-bfd0-8cb5e5785b70",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "ullamco voluptate commodo est",
        "brand_id": "9b831880-61b5-549f-682f-f674572c5c7a",
        "offline_payments": true,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1918-04-05T04:21:32.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "bbdacc48-7790-e9fe-634f-9fa17abcb6f5",
            "membership_type_id": "f25e18eb-9892-9fa8-35d2-63a7bc8adffb",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1916-09-11T07:43:31.0Z",
            "updated_at": "1893-06-13T22:08:51.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1948-09-30T17:41:17.0Z",
        "updated_at": "1939-03-10T02:49:34.0Z",
        "deleted_at": "1906-04-26T11:10:56.0Z"
      },
      "payment_details_url": "proident Lorem dolore incididunt",
      "created_at": "1923-06-26T06:57:54.0Z"
    },
    {
      "id": "4c4833b0-e8ca-10ba-7d62-bcd6fd4390e6",
      "attention_reason": "mandate_revoked",
      "basket_id": "69f1e78a92b75201480000af",
      "customer": {
        "id": "ded810bf-f5ab-2028-4792-8cc93668dafd",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1969-06-23",
        "brand_id": "3eed3c59-5f1c-69ce-f103-4fb0c41c4248",
        "site_id": "34625c01-178b-534b-a6dc-cea800750ddd",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "c95a0b4e-e41a-168c-0e76-e319e6d4b727",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "c4f72f20-feb2-aac6-01af-a0792e7c2427",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "21b2c050-c663-3ce5-0511-6d4bcd9807db",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "26315ba3-e3a5-5776-e900-6a34cd7ad196",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1961-08-16T02:58:13.0Z",
        "created_at": "1947-10-01T07:01:08.0Z",
        "updated_at": "1954-08-21T08:14:28.0Z",
        "deleted_at": "1940-12-16T01:34:10.0Z",
        "last_active_at": "1937-04-30T10:11:44.0Z",
        "email_verified_at": "1917-05-20T16:06:28.0Z",
        "last_check_in": {
          "checked_in_at": "1949-02-18T05:07:19.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "0ecb7431-0a81-d787-ce94-bcf2543660b7",
          "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": "cupidatat et nisi"
      },
      "end_date": "1928-12-14T13:08:32.0Z",
      "external_ref": "pariatur quis",
      "members": [
        {
          "customer_id": "f15ae0ec-743a-dc47-f0ad-0641911c9081",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "0c514e05-0577-900b-f8d4-5627709c2431",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "5e24ab7a-136a-e33f-9765-78bfffa83cf3",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1956-05-28T17:49:01.0Z",
      "next_charge": {
        "id": "1b13e6fc-388c-bccc-dc9b-54d5ab3b5f2d",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1920-02-08",
        "billing_period_to": "1966-07-08"
      },
      "payment_method": {
        "id": "consequat cillum sed",
        "type": "direct_debit",
        "last_4": "fugiat minim",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "f83dead5-6229-84c8-31e3-a50f48358f87",
        "membership_type_id": "9a4a6096-0879-f46c-fc9c-42d94f59cf36",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "Excepteur",
          "proident ut aliquip Ut"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1960-01-16T04:59:37.0Z",
        "updated_at": "1961-05-27T16:03:44.0Z"
      },
      "site_id": "0bcc7c4f-cde8-3922-847f-dd04202e4a0e",
      "source": "self_signup",
      "start_date": "1935-04-14T10:08:41.0Z",
      "status": "active",
      "status_updated_at": "1907-06-07T11:22:21.0Z",
      "type": {
        "id": "bc7ae574-8218-4c4d-c3ce-bb403034f770",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "elit",
        "brand_id": "2651cd8e-f21b-275f-d0ff-c95a96289a7d",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "private",
        "minimum_start_date": "1911-10-25T04:34:41.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "708fcc6e-17db-2d0b-327b-216be62eb279",
            "membership_type_id": "dffcebbf-83cd-20cb-9a1f-2eb41a7e0ac5",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "cillum",
              "magna officia",
              "ipsum reprehenderit proident culpa"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1898-08-31T03:34:28.0Z",
            "updated_at": "1899-05-20T17:11:48.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1909-05-20T21:45:45.0Z",
        "updated_at": "1943-05-29T10:57:09.0Z",
        "deleted_at": "1968-08-06T22:23:06.0Z"
      },
      "payment_details_url": "ipsum ad et",
      "created_at": "1956-01-04T17:10:10.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": "50ee8e62-1192-65f0-a64d-cd3326bc2400",
    "attention_reason": "payment_disputed",
    "basket_id": "69f1e78a92b75201480000b0",
    "customer": {
      "id": "6c4e2032-acd8-d57f-72f4-154cd5643f88",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1897-11-06",
      "brand_id": "5a506ee9-4560-b0d4-09ad-3654586a3c70",
      "site_id": "029d69c1-6468-a117-ae48-bc4848c655b5",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [
        {
          "id": "eac9424a-755a-21ce-5bc7-9d966e171c91",
          "value": "VIP",
          "colour": "ff6634"
        }
      ],
      "preferred_locale": "en",
      "locked_at": "1922-01-11T11:06:27.0Z",
      "created_at": "1956-12-14T20:24:57.0Z",
      "updated_at": "1937-08-31T01:18:48.0Z",
      "deleted_at": "1895-02-03T05:12:20.0Z",
      "last_active_at": "1945-04-30T21:56:12.0Z",
      "email_verified_at": "1960-05-29T23:30:32.0Z",
      "last_check_in": {
        "checked_in_at": "1911-10-19T12:01:40.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "b87c6e4a-1181-91fe-e03b-c75890f5ba6a",
        "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": "voluptate fugiat quis aute sit"
    },
    "end_date": "1900-06-27T17:49:27.0Z",
    "external_ref": "irure proident aliquip",
    "members": [
      {
        "customer_id": "b10141bc-3b23-aae4-1dff-867650882e18",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "c360c1b3-1bdb-7c07-6732-fa045ac8f8f8",
        "is_lead": false,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "2871cbe5-332b-77b3-f131-c01b10fa0479",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "a452dee7-4530-c3d8-6eda-dca3964421e4",
        "is_lead": false,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1903-07-15T03:01:13.0Z",
    "next_charge": {
      "id": "3b13880c-0e42-8372-9884-55a440156341",
      "amount": 3995,
      "currency": "GBP",
      "status": "failed",
      "billing_period_from": "1926-05-11",
      "billing_period_to": "1921-11-01"
    },
    "payment_method": {
      "id": "cupidatat dolor",
      "type": "card",
      "last_4": "Duis dolore id",
      "status": "revoked"
    },
    "rate": {
      "id": "05aabd3d-e08e-b108-c9a5-ed2d46f89cf1",
      "membership_type_id": "719e3318-dfae-3778-2a9a-2f4678d645bf",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "elit Lorem ullamco occaecat veniam",
        "dolor dolore"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1903-06-03T17:10:25.0Z",
      "updated_at": "1903-04-24T02:08:22.0Z"
    },
    "site_id": "07621704-10c0-7607-9bdf-a884322a3246",
    "source": "unknown",
    "start_date": "1913-09-14T12:41:06.0Z",
    "status": "needs_attention",
    "status_updated_at": "1906-04-21T01:46:14.0Z",
    "type": {
      "id": "94969d2c-e681-214b-8ae3-f0305b949ca8",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "id culpa",
      "brand_id": "1203e916-9343-3315-88f5-70d3c03478b4",
      "offline_payments": true,
      "disable_confirmation_email": false,
      "private": false,
      "visibility": "private",
      "minimum_start_date": "1892-11-08T13:59:29.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "d2fbd881-1589-1ca3-20d8-b8d92be1890d",
          "membership_type_id": "2bd2db79-4401-0a12-8322-62e9c09299bf",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "fugiat",
            "Duis",
            "ullamco voluptate id in proident"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1902-11-22T05:44:41.0Z",
          "updated_at": "1911-07-24T21:06:41.0Z"
        },
        {
          "id": "c07ef189-5cab-21ab-4fbf-667a8a6a4692",
          "membership_type_id": "fc969b47-2837-9aab-9a98-75596c4fd532",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "dolore commodo tempor sunt",
            "fugiat enim",
            "ut cupidatat"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1953-11-03T16:46:30.0Z",
          "updated_at": "1901-05-28T19:35:35.0Z"
        },
        {
          "id": "0f823afa-d638-217e-e102-011e7532f012",
          "membership_type_id": "19882054-8cc0-1849-a956-d65073487155",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1919-01-10T15:51:55.0Z",
          "updated_at": "1905-04-19T01:57:03.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1961-10-10T09:48:37.0Z",
      "updated_at": "1960-03-30T02:56:44.0Z",
      "deleted_at": "1919-09-02T15:53:38.0Z"
    },
    "payment_details_url": "in elit",
    "created_at": "1918-11-09T04:01:56.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": "5768be94-f0ec-3c5d-4637-77facbd6b5d6",
    "membership": {
      "id": "5fb46ad4-6662-4c2b-173e-afe005b3db8f",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "cd586405-be05-4154-61f9-b00c40109fa3"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "processor_type_id": "69f1e78b92b7520148000393"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "consectetur",
    "can_download_receipt": false,
    "amount_refunded": -34972263,
    "refunded": false,
    "refunds": [
      {
        "id": "88b31a1f-a0dc-136a-166c-bb0f111a22b0",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "71eed7b2-076b-ded6-ecc3-684effea682b",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1934-09-02T19:44:08.0Z",
        "updated_at": "1933-04-03T22:21:07.0Z"
      },
      {
        "id": "2cbde4b6-e518-9b8d-be5d-2c1fe0014a65",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "a6f85d97-b1d8-f7d9-4496-3e91e00c0de3",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1910-08-19T17:04:12.0Z",
        "updated_at": "1920-06-29T14:14:47.0Z"
      }
    ],
    "site_id": "4c5a738c-2db0-68ba-0f48-ab6e49b41f5d",
    "billing_period_from": "1945-11-14",
    "billing_period_to": "1947-06-16",
    "processing_at": "1953-11-30T10:07:23.0Z",
    "created_at": "1954-06-10T01:14:01.0Z",
    "updated_at": "1903-11-06T07:06:38.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": "3ea5dc30-11a8-2a5b-7cba-4150591d8b6e",
    "membership": {
      "id": "3228c25a-088e-8884-ad14-e1c9997bbfb6",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "ea9cafca-956b-b0b0-ebc4-35c9aab9564c",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69f1e78a92b75201480000b1"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "nisi",
    "can_download_receipt": true,
    "amount_refunded": -65237475,
    "refunded": true,
    "refunds": [
      {
        "id": "244b9fb4-99b5-878f-6a00-163c56130a28",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1969-12-20T04:07:43.0Z",
        "updated_at": "1959-07-13T21:17:48.0Z"
      },
      {
        "id": "5786c770-15cd-c4f7-24e5-03ec2951c0b1",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "6e8db3cd-8c87-c631-baac-cef078ba9774",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1931-08-11T05:06:43.0Z",
        "updated_at": "1957-08-14T14:23:14.0Z"
      }
    ],
    "site_id": "011fe07e-9c84-36ec-e212-33e788bfbe28",
    "billing_period_from": "1901-09-28",
    "billing_period_to": "1930-10-29",
    "processing_at": "1954-05-28T23:17:48.0Z",
    "created_at": "1956-03-18T13:41:28.0Z",
    "updated_at": "1968-07-28T02:01:21.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": "cba88f51-9657-07d5-fdb6-21c165256bba",
    "membership": {
      "id": "8b8caeb8-bbb6-fd1a-70fa-2b682b799019",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "ba708642-2fce-f9a8-8b16-19521f09f439",
      "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": "velit",
    "can_download_receipt": true,
    "amount_refunded": 60202507,
    "refunded": false,
    "refunds": [
      {
        "id": "5b1d3e37-439f-3e23-fa58-5f44131e1431",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "b6ba3ecc-4be3-caaa-4bc4-3fffd2b62cda",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1953-10-11T02:56:55.0Z",
        "updated_at": "1938-08-04T10:37:01.0Z"
      }
    ],
    "site_id": "1c40564a-9662-dfe3-95a2-9f4b01694d9d",
    "billing_period_from": "1921-05-30",
    "billing_period_to": "1917-09-26",
    "processing_at": "1912-11-14T08:21:18.0Z",
    "created_at": "1910-06-09T06:10:36.0Z",
    "updated_at": "1966-02-26T15:56: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": "69f1e78b92b7520148000394",
    "organisation_id": "033cc7c5-1f23-7234-48c4-ce6febd667b7",
    "site_id": "eeb51fbc-210b-8238-62d6-7197606ffa6c",
    "customer_id": "fb01f3ae-8341-aa13-d1f2-33de4f637799",
    "membership_id": "fa658374-5c66-059b-7056-e9e2c8e1ded8",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "nulla consequat laboris quis",
    "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": {
    "sit_986": [
      "Excepteur commodo amet sed proident",
      "irure sit",
      "commodo sunt",
      "cillum",
      "occaecat"
    ],
    "in63": [
      "Lorem consequat in laborum Duis",
      "eu consequat Duis aliquip id",
      "Lorem cillum",
      "in",
      "aute cupidatat sint mollit ad"
    ]
  },
  "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": "77051fe8-5e24-9588-d44e-df223f942775",
    "organisation_id": "704882d2-8f01-8fde-b118-caffe9264595"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}