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": "8c2fce1f-9f20-21d9-56c0-fb465d8d96ce",
      "attention_reason": "mandate_revoked",
      "basket_id": "69cbc8273b26d0015200009e",
      "customer": {
        "id": "256123d2-05e3-d854-7db5-103511081708",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1904-01-06",
        "brand_id": "ca2d80c2-677b-a45c-fc9d-d757cc317750",
        "site_id": "c3802f22-2378-1a2d-83b1-f5f122c46725",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "c20644c4-db74-21ae-f099-2a86d67920b8",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "799b8e49-b52e-a2d6-00e2-ab3395cffb93",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "e2b01f61-f885-4638-9695-6fd152fbc8ae",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1958-05-17T11:53:54.0Z",
        "created_at": "1945-11-18T01:38:29.0Z",
        "updated_at": "1936-12-03T05:58:30.0Z",
        "deleted_at": "1905-11-21T12:37:09.0Z",
        "last_active_at": "1926-04-17T17:34:40.0Z",
        "email_verified_at": "1937-10-15T14:56:08.0Z",
        "last_check_in": {
          "checked_in_at": "1903-08-30T20:35:54.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "a087b4fc-26da-a21e-386b-cc253f91069d",
          "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": "Lorem amet consequat nisi"
      },
      "end_date": "1962-03-19T01:54:14.0Z",
      "external_ref": "fugiat",
      "members": [
        {
          "customer_id": "95763eb1-8052-5e1b-3f98-a76c6008354b",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "e46ad492-27a8-2541-83d2-6210273f3a77",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "8f45e2d2-bcea-73bf-50c6-5923ba3a4a59",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "f31b6e5b-b97d-8608-eefb-1ed9a94ee570",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "2ad28b36-a7a1-2a6f-8391-9b360fad3239",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1968-06-10T03:12:11.0Z",
      "next_charge": {
        "id": "062a7326-1738-6ad1-af17-0099782a6715",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1942-03-06",
        "billing_period_to": "1959-06-28"
      },
      "payment_method": {
        "id": "voluptate Lorem",
        "type": "direct_debit",
        "last_4": "ea",
        "card_brand": "amex"
      },
      "rate": {
        "id": "58fab630-9f4d-0799-a899-63eb32bc2335",
        "membership_type_id": "efcdb0d0-e462-3c4e-f49d-a2d3e58b18be",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "incididunt aliquip amet elit consectetur"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1967-06-07T23:08:17.0Z",
        "updated_at": "1917-11-21T21:34:42.0Z"
      },
      "site_id": "0a39e058-7a16-b038-c2f4-91b6c6d4c99c",
      "source": "import",
      "start_date": "1901-07-07T08:47:37.0Z",
      "status": "expired",
      "status_updated_at": "1964-03-06T13:35:57.0Z",
      "type": {
        "id": "5e63263f-d308-dd06-bb4b-2db360dc7398",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "amet proident eu irure",
        "brand_id": "dbc4c09d-93c2-6522-f700-5cc51b8655dc",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": true,
        "visibility": "private",
        "minimum_start_date": "1945-06-20T06:01:55.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "748d415a-54a6-5e66-e3b5-d4678ec718a4",
            "membership_type_id": "35e9e9e7-f4a3-f918-02e9-8802dfb89243",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "elit minim proident"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1936-07-24T16:02:48.0Z",
            "updated_at": "1947-01-30T09:28:42.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1910-02-16T04:28:20.0Z",
        "updated_at": "1960-10-07T17:03:08.0Z",
        "deleted_at": "1908-02-11T01:04:39.0Z"
      },
      "payment_details_url": "in tempor",
      "created_at": "1954-05-25T10:52:43.0Z"
    },
    {
      "id": "5cf8d901-bab5-bbd4-f730-1089ff38d3d4",
      "attention_reason": "site_id",
      "basket_id": "69cbc8273b26d0015200009f",
      "customer": {
        "id": "1ad5427f-c9a7-6e0f-dc50-0a68948d667b",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1968-05-24",
        "brand_id": "896ed117-2d2c-5835-bcff-321c2b2e6ec8",
        "site_id": "dfb5a697-6a4c-3cc7-255f-4564495c3cf9",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "90ab4855-05ee-7f9c-b57f-39db03d81fab",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "15fdff9f-f8d9-e5b3-b2a5-81f61097a3b5",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "b2a890c5-63e0-51e3-df37-8bca07537904",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "17425409-3ef3-8ba8-a443-ba16216d5604",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1906-05-13T09:45:34.0Z",
        "created_at": "1914-05-03T20:26:28.0Z",
        "updated_at": "1965-09-13T23:45:43.0Z",
        "deleted_at": "1936-11-08T14:31:33.0Z",
        "last_active_at": "1921-09-16T22:43:34.0Z",
        "email_verified_at": "1896-08-01T11:51:04.0Z",
        "last_check_in": {
          "checked_in_at": "1932-09-01T01:38:39.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "9812d9ee-788b-f95e-f5be-cc910735ea36",
          "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": "do veniam cillum"
      },
      "end_date": "1890-08-13T14:22:30.0Z",
      "external_ref": "nisi amet eu",
      "members": [
        {
          "customer_id": "a0939bff-c34a-3e07-0e83-d2b166de520f",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "83fd488c-f90d-1dd9-e555-b769585908ca",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "b3e4e71e-5766-fd3d-d7d1-9ac9752712c2",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "c90bd5a9-8fa1-31c5-cdd7-77ec220a297f",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1956-11-21T22:01:26.0Z",
      "next_charge": {
        "id": "1b685118-8807-221c-16f8-b7a7efdf6ccd",
        "amount": 3995,
        "currency": "GBP",
        "status": "succeeded",
        "billing_period_from": "1917-04-20",
        "billing_period_to": "1900-05-08"
      },
      "payment_method": {
        "id": "ad occaecat exercitation",
        "type": "card",
        "last_4": "ad et",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "638842b8-a729-85ab-2f1d-4e59993cffdd",
        "membership_type_id": "3eef804f-1351-02b5-d0bf-670d61f5669a",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "deserunt nisi",
          "dolore exercitation officia"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1896-10-21T19:04:31.0Z",
        "updated_at": "1944-12-03T12:11:16.0Z"
      },
      "site_id": "454673cd-822d-3011-2d9c-5ae58849f576",
      "source": "unknown",
      "start_date": "1961-10-07T15:30:37.0Z",
      "status": "inactive",
      "status_updated_at": "1901-12-01T23:28:21.0Z",
      "type": {
        "id": "adecab23-b45d-e6f0-bda3-1099a7b23111",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "esse deserunt est velit veniam",
        "brand_id": "46b8e123-ad69-e7ea-3575-ccfa8ae97144",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": false,
        "visibility": "private",
        "minimum_start_date": "1964-09-04T03:22:44.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "81f86045-7967-d369-087e-ed51cdfb14c0",
            "membership_type_id": "a9c99984-2d7b-f46b-3c74-6e682665c688",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "fugiat anim sed sunt",
              "dolore ut esse Lorem ex",
              "consectetur"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1929-09-06T19:52:34.0Z",
            "updated_at": "1916-01-14T22:54:52.0Z"
          },
          {
            "id": "3bc34e2f-efe0-13c0-eb9d-941b213c238e",
            "membership_type_id": "054dcbbc-2729-0639-500f-e687e1a31d53",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sed dolore eu enim aute",
              "dolor velit deserunt cupidatat esse",
              "sunt minim est officia"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1961-01-12T16:55:46.0Z",
            "updated_at": "1915-02-17T04:19:50.0Z"
          },
          {
            "id": "fafd165a-1a4e-4d9e-809a-613330c402e3",
            "membership_type_id": "e0a6cd91-c5d1-48e8-8775-648469230300",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1936-09-23T14:27:51.0Z",
            "updated_at": "1950-11-23T21:42:49.0Z"
          },
          {
            "id": "56245246-a4d9-dd3d-13e7-ea7f842f042a",
            "membership_type_id": "af93755b-936f-2427-dbc9-c25499d7c5c7",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "voluptate",
              "deserunt Ut enim fugiat",
              "culpa",
              "id aliquip velit sint et"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1904-05-21T10:19:38.0Z",
            "updated_at": "1900-09-19T15:35:22.0Z"
          },
          {
            "id": "4166ca69-6823-98fd-e49c-627ce5559a55",
            "membership_type_id": "6792cea6-a5fe-e653-5219-0c1f94ac6efe",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "nostrud labore in",
              "pariatur reprehenderit fugiat"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1893-08-16T09:16:23.0Z",
            "updated_at": "1911-10-09T15:37:28.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1952-06-17T04:09:15.0Z",
        "updated_at": "1940-12-19T01:54:28.0Z",
        "deleted_at": "1948-04-28T18:16:43.0Z"
      },
      "payment_details_url": "Lorem enim est",
      "created_at": "1906-07-18T12:14:34.0Z"
    },
    {
      "id": "9e18e65a-f044-2a1c-e0f0-67982d295b39",
      "attention_reason": "site_id",
      "basket_id": "69cbc8273b26d001520000a0",
      "customer": {
        "id": "361c585b-9d27-3cb8-1843-3de6bb3851fa",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1932-08-19",
        "brand_id": "332af0e9-6cfa-bd8e-3f0b-7051d025e330",
        "site_id": "e7d47f16-ba05-003f-5a86-6f973f1663e4",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "a812daf3-42f8-4695-b69d-98ef006bf0ea",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "4f4a2c18-f443-2b18-54f7-308cfd75477e",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1957-04-04T10:29:24.0Z",
        "created_at": "1908-01-10T16:23:04.0Z",
        "updated_at": "1920-09-16T18:24:36.0Z",
        "deleted_at": "1965-05-24T06:30:20.0Z",
        "last_active_at": "1957-02-16T19:05:44.0Z",
        "email_verified_at": "1927-08-31T23:52:04.0Z",
        "last_check_in": {
          "checked_in_at": "1916-10-19T13:33:54.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "8880ce43-d02c-7f4c-7956-caa27f6571cc",
          "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": "velit in consequat ipsum Duis"
      },
      "end_date": "1961-03-14T18:01:16.0Z",
      "external_ref": "anim eiusmod sunt id",
      "members": [
        {
          "customer_id": "e2635c6e-2511-9fa5-906f-2bd08af007c9",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "82cc95aa-c414-19a0-1f16-47492e6d47dc",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "807cd159-8bf5-6efc-b4f3-415c9aa64e24",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "f95254d5-0bb8-0b90-511d-3353fc34fbb0",
          "is_lead": false,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1968-11-16T18:01:31.0Z",
      "next_charge": {
        "id": "526baf4d-e7e2-1f3f-6750-db616ce60694",
        "amount": 3995,
        "currency": "GBP",
        "status": "pending",
        "billing_period_from": "1968-08-11",
        "billing_period_to": "1911-11-30"
      },
      "payment_method": {
        "id": "nostrud elit eiusmod incididunt",
        "type": "card",
        "last_4": "dolore sint",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "682b75f0-8f92-62d4-9421-5977f85aa1eb",
        "membership_type_id": "da7dcb81-8e55-9e33-8e92-1b70bb8ad8ce",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1956-07-25T10:30:40.0Z",
        "updated_at": "1959-09-16T20:12:20.0Z"
      },
      "site_id": "b0ce23a5-2da7-a585-1910-a7a1c1e02374",
      "source": "unknown",
      "start_date": "1941-07-02T04:02:20.0Z",
      "status": "active",
      "status_updated_at": "1899-04-18T03:37:49.0Z",
      "type": {
        "id": "42eb2967-6f26-9579-4a02-2057f06c17cc",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "et labore",
        "brand_id": "6f9eb732-d9cf-5ebe-fa2c-92809e037bd8",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "public",
        "minimum_start_date": "1897-01-25T01:13:12.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "048659f2-3289-8bba-ea24-77fd7d313b4e",
            "membership_type_id": "f2cfb109-252c-efef-e82b-563a4986d4aa",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "consectetur dolor occaecat magna",
              "eu cillum esse minim",
              "tempor"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1914-12-01T20:30:38.0Z",
            "updated_at": "1950-07-12T01:36:38.0Z"
          },
          {
            "id": "0b8c7d08-78e9-766b-0c7f-6f867fd6508e",
            "membership_type_id": "d8b6e20b-9ad1-8199-d055-da2ebb783f8d",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "reprehenderit elit",
              "eiusmod ad Ut",
              "eu dolor esse voluptate magna",
              "nulla tempor magna"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1928-12-06T01:05:32.0Z",
            "updated_at": "1909-09-05T23:50:44.0Z"
          },
          {
            "id": "90df4ef4-fbf5-b6f2-afce-2d7bb7c7cb02",
            "membership_type_id": "741adbbf-801c-d938-181c-b8811bca6a0c",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ut veniam culpa anim velit",
              "culpa ut tempor enim"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1965-08-12T01:47:45.0Z",
            "updated_at": "1924-08-15T01:03:43.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1905-12-02T23:12:29.0Z",
        "updated_at": "1967-12-15T23:33:37.0Z",
        "deleted_at": "1899-04-29T16:38:57.0Z"
      },
      "payment_details_url": "est laborum",
      "created_at": "1922-12-30T13:01:23.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": "b3e8dc0f-949d-a661-d7bd-cd10368968ba",
    "attention_reason": "mandate_revoked",
    "basket_id": "69cbc8273b26d001520000a1",
    "customer": {
      "id": "915f4025-11c7-8c06-eea7-17e3ebf24ea5",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1893-01-29",
      "brand_id": "189fbbf4-c30e-48a5-f2b6-0135ecc395db",
      "site_id": "90b9653c-d1bd-b33e-9976-db08de92478b",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [],
      "preferred_locale": "en",
      "locked_at": "1924-03-23T05:46:22.0Z",
      "created_at": "1943-02-18T19:12:17.0Z",
      "updated_at": "1964-02-17T08:48:23.0Z",
      "deleted_at": "1912-05-20T14:15:19.0Z",
      "last_active_at": "1967-11-15T02:35:42.0Z",
      "email_verified_at": "1940-08-13T06:04:28.0Z",
      "last_check_in": {
        "checked_in_at": "1907-12-05T11:09:08.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "5f2cf161-b222-ba4c-4e84-531e6d49c47e",
        "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": "nostrud reprehenderit est et Duis"
    },
    "end_date": "1944-09-05T05:10:12.0Z",
    "external_ref": "reprehenderit Duis incididunt irure esse",
    "members": [
      {
        "customer_id": "08ff8422-e909-1bfd-dfd5-d82fbee08058",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "81ff36e6-7a5b-8872-03cb-68a1c73317ec",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "c7e5fec9-63ff-9e71-9afc-90bf70323047",
        "is_lead": true,
        "membership_number": "1234567890"
      },
      {
        "customer_id": "50b0c1d2-cb9d-1fab-d1ef-3b7ae1b44260",
        "is_lead": false,
        "membership_number": "1234567890"
      }
    ],
    "membership_number": "1234567890",
    "next_billing_date": "1936-09-06T15:46:03.0Z",
    "next_charge": {
      "id": "c8354fbd-6369-f673-75c5-07520375b43b",
      "amount": 3995,
      "currency": "GBP",
      "status": "processing",
      "billing_period_from": "1890-07-22",
      "billing_period_to": "1908-06-28"
    },
    "payment_method": {
      "id": "dolor id Lorem quis",
      "type": "direct_debit",
      "last_4": "in",
      "card_brand": "amex"
    },
    "rate": {
      "id": "71104765-3179-d1ea-6e43-30bbcb9bafe9",
      "membership_type_id": "97257aa9-c2de-a5b7-7ecf-fcbfbc2d7cd3",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "cupidatat sunt ea",
        "nulla fugiat labore",
        "voluptate"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1903-04-25T12:52:52.0Z",
      "updated_at": "1926-08-04T01:23:26.0Z"
    },
    "site_id": "23371ad4-8483-c85a-7445-88892e6ff085",
    "source": "self_signup",
    "start_date": "1942-12-24T17:40:40.0Z",
    "status": "active",
    "status_updated_at": "1899-06-27T15:12:55.0Z",
    "type": {
      "id": "e9d642ea-9862-6cca-e87a-631a51d3722c",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "cillum cupidatat in eiusmod",
      "brand_id": "e1914f5e-0a22-2bfa-30a3-6b181f888da5",
      "offline_payments": false,
      "disable_confirmation_email": true,
      "private": true,
      "visibility": "public",
      "minimum_start_date": "1894-07-12T11:22:58.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "7967e711-4d6e-fc25-5b03-ddc680444f2e",
          "membership_type_id": "30634705-b20e-25c5-44d5-993aed94f846",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "occaecat",
            "est consequat mollit labore"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1958-05-06T08:14:13.0Z",
          "updated_at": "1932-09-15T06:25:04.0Z"
        },
        {
          "id": "b7b0e06a-729a-675d-de6a-f8a63182f62d",
          "membership_type_id": "64ef9d30-b923-9b20-22aa-fb4fa94340a4",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "id",
            "eiusmod"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1929-08-11T05:27:30.0Z",
          "updated_at": "1896-05-14T09:32:31.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1932-01-12T21:35:48.0Z",
      "updated_at": "1966-04-05T19:28:01.0Z",
      "deleted_at": "1892-11-04T12:51:04.0Z"
    },
    "payment_details_url": "occaecat eu fugiat ut",
    "created_at": "1911-10-21T07:29:23.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": "bc57876d-8472-87da-5272-8a26eeee0eed",
    "membership": {
      "id": "e821d7a6-72c1-9ada-36e5-955ee86c5407",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "0fa63de1-f6b6-38e4-4f8e-fcea2c2e54f8",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69cbc8283b26d00152000278"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "exercitation enim quis",
    "can_download_receipt": false,
    "amount_refunded": 24563495,
    "refunded": true,
    "refunds": [
      {
        "id": "bcfe9dbd-6fd3-f10b-76fd-6fc283ca82a1",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "ae1c43df-7304-d6bc-cea5-7a3e4622e242",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1903-08-31T13:36:33.0Z",
        "updated_at": "1939-03-14T14:17:03.0Z"
      },
      {
        "id": "8e0ad561-d592-39d0-28de-1a32492dad27",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "43450669-3d3b-829d-9bc7-f973806c5593",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1907-01-05T06:35:31.0Z",
        "updated_at": "1954-09-11T09:57:04.0Z"
      },
      {
        "id": "96aaf34f-a509-6eeb-0491-05b5b11a32a2",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "24d81231-dbea-8ffa-94b4-b484fe00da48",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1921-07-03T06:20:18.0Z",
        "updated_at": "1901-05-07T20:22:44.0Z"
      },
      {
        "id": "9628ef61-5268-62de-30f7-a64b00506cc4",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "accc6b89-a32a-6fa0-e1f1-4d71bf489742",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1895-01-20T23:37:07.0Z",
        "updated_at": "1909-12-02T03:08:19.0Z"
      },
      {
        "id": "5e23c739-e839-dd6f-5e8a-42bde2cb6b2f",
        "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": "1949-01-25T11:18:17.0Z",
        "updated_at": "1969-08-23T16:57:13.0Z"
      }
    ],
    "site_id": "a4487815-8efb-3546-a87f-51e34be4dfc8",
    "billing_period_from": "1933-01-15",
    "billing_period_to": "1952-04-03",
    "processing_at": "1952-06-26T20:23:32.0Z",
    "created_at": "1943-01-13T07:09:28.0Z",
    "updated_at": "1934-08-09T06:30:44.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
actionProcessMembershipCharge

Manually process a charge for a membership

This endpoint allows a membership charge to be processed manually.

Path parameters

Responses

  • 200

    A charge against a membership.

  • 404

    The resource couldn't be found

POST/shop/membership-charges/{chargeId}/process
200
example response
{
  "data": {
    "id": "7d535a03-ddd0-4d83-43ff-906d884c0137",
    "membership": {
      "id": "507e31ee-8d95-d186-060c-f45eaece4a79",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "55013131-54ef-1bee-bad7-778ea6157c02",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69cbc8273b26d001520000a2"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "ullamco",
    "can_download_receipt": true,
    "amount_refunded": 86174919,
    "refunded": true,
    "refunds": [
      {
        "id": "9f2b61b1-edcd-9164-d29d-fe89693f503c",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "c3b92129-e822-8f39-f166-c59c98bd4405",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1919-05-22T13:19:54.0Z",
        "updated_at": "1925-10-28T12:49:12.0Z"
      },
      {
        "id": "2d8be731-9cd4-b77c-6a99-06c83ecdec13",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "8a1ac977-33bf-b40d-925f-9eafd9bcf98d",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1967-01-18T03:34:43.0Z",
        "updated_at": "1933-09-15T03:42:35.0Z"
      },
      {
        "id": "96063fba-af40-7685-0fdc-1638fb805ea0",
        "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": "1922-06-20T13:58:56.0Z",
        "updated_at": "1916-05-26T02:19:42.0Z"
      },
      {
        "id": "ff40bf26-6969-3c43-36b8-ca7b9493972d",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1896-12-27T20:20:23.0Z",
        "updated_at": "1967-04-21T01:27:45.0Z"
      }
    ],
    "site_id": "5aa5da6e-dca9-b016-5d56-e192521b8599",
    "billing_period_from": "1912-03-26",
    "billing_period_to": "1902-11-07",
    "processing_at": "1954-04-01T19:26:54.0Z",
    "created_at": "1902-11-07T19:29:40.0Z",
    "updated_at": "1896-06-27T17:04:08.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": "f66b5e59-872c-62d1-02c7-8a7d98761c12",
    "membership": {
      "id": "5ce4d245-0493-015e-e1a8-37cc10be65ee",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "f59c4f4d-b605-7415-fead-d2dcfd67fd63",
      "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": "dolor nulla",
    "can_download_receipt": false,
    "amount_refunded": -12475701,
    "refunded": true,
    "refunds": [
      {
        "id": "5894986e-1e34-04b0-26d3-5ef05a7fbb30",
        "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": "1938-08-18T14:37:54.0Z",
        "updated_at": "1904-05-27T23:51:54.0Z"
      },
      {
        "id": "7e9a48e4-fa05-9d56-b687-249cd24aa9c3",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "4cf90374-9ed7-2571-b77b-4958eb027b35",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1944-11-24T21:01:02.0Z",
        "updated_at": "1900-07-12T03:40:58.0Z"
      },
      {
        "id": "9fc846c3-d81d-dce2-96d4-40f014e513b7",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "588e05c8-bce6-90a7-1386-16b4849b35c1",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1893-01-08T08:34:38.0Z",
        "updated_at": "1962-10-05T13:29:27.0Z"
      },
      {
        "id": "66834cad-3b50-c4b9-721e-68be04a402f5",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e750c413-256f-80b7-7c20-f3ff2cf25b3f",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1954-06-11T17:38:32.0Z",
        "updated_at": "1959-01-27T03:46:01.0Z"
      }
    ],
    "site_id": "3b7d41a2-0251-ed22-cfa8-6037e75aa06d",
    "billing_period_from": "1920-03-10",
    "billing_period_to": "1893-11-21",
    "processing_at": "1951-01-22T21:34:32.0Z",
    "created_at": "1944-03-15T06:37:39.0Z",
    "updated_at": "1901-01-04T07:09:45.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": "69cbc8283b26d00152000279",
    "organisation_id": "33b642d7-13a2-938a-5998-3c5c2762499f",
    "site_id": "56a92579-ef3a-eae2-5497-04939c452324",
    "customer_id": "364deb21-9b2c-7ec4-e0d1-180c10597801",
    "membership_id": "224826b5-0de5-d6d7-464f-73f11f48e210",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "in anim",
    "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": {
    "anim_4": [
      "voluptate ad dolore non",
      "elit officia ad Lorem dolor",
      "minim",
      "ea Ut exercitation"
    ]
  },
  "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": "018ace06-7d09-e97c-0b67-9eb1a05ca049",
    "organisation_id": "61bd3fb4-0ca5-d593-e84c-453b4c8527d5"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}