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": "b99d2db6-aec2-9cfb-cf30-8952e71598a9",
      "attention_reason": "setup_unpaid",
      "basket_id": "69de37239035b4015400008a",
      "customer": {
        "id": "faf79a7f-ab3c-e1a0-b527-061f07d72d44",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1962-06-29",
        "brand_id": "faa2304a-80f6-c074-9481-5782f37021af",
        "site_id": "c2ddd88d-93f6-01b9-c8ce-b44338c684b3",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "6bbdd101-0176-3d7c-1d5e-74543bbd8e86",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "688fc04b-d698-c714-17bf-9ab89bb48bf0",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1897-01-22T10:22:21.0Z",
        "created_at": "1916-10-29T15:01:25.0Z",
        "updated_at": "1966-06-10T06:09:12.0Z",
        "deleted_at": "1904-05-07T19:58:38.0Z",
        "last_active_at": "1953-11-22T04:36:11.0Z",
        "email_verified_at": "1935-07-11T15:13:17.0Z",
        "last_check_in": {
          "checked_in_at": "1928-06-25T18:23:39.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "b209fbcc-6fc7-3d5a-4893-4662016c3714",
          "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": "aute"
      },
      "end_date": "1921-01-09T03:02:25.0Z",
      "external_ref": "incididunt aute non sit do",
      "members": [
        {
          "customer_id": "55d5fcef-b6ff-8bd7-7b90-004832ca2b8a",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "35aa93f1-9f6b-105d-2d0f-27ae30f86e35",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "213c9c8b-e845-103c-17b6-b41c106ff1e2",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "e72a5a04-f555-3d3f-882a-25e039d818aa",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "4fa9667b-9419-e193-6a4d-e720dabcafa4",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1945-07-15T02:26:29.0Z",
      "next_charge": {
        "id": "135100a7-64f3-849b-06c1-e709ac88cc0b",
        "amount": 3995,
        "currency": "GBP",
        "status": "succeeded",
        "billing_period_from": "1966-09-22",
        "billing_period_to": "1913-08-25"
      },
      "payment_method": {
        "id": "do laboris cillum consequat ipsum",
        "type": "card",
        "last_4": "cillum culpa pariatur"
      },
      "rate": {
        "id": "cafe915a-3df4-7204-787b-e5873ff84d25",
        "membership_type_id": "e00ae2bf-0c7a-c078-6e50-86a90612fa44",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "elit ex ut",
          "minim nisi",
          "aliqua est aliquip irure",
          "velit eu elit aute in"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1962-07-26T04:42:41.0Z",
        "updated_at": "1927-10-04T02:09:51.0Z"
      },
      "site_id": "fa63cd16-0b61-fd7c-c849-980acf83b7b4",
      "source": "unknown",
      "start_date": "1898-01-24T18:27:02.0Z",
      "status": "inactive",
      "status_updated_at": "1945-03-29T19:23:17.0Z",
      "type": {
        "id": "56a27f69-75bd-758d-c72e-d33772bc1fc2",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "esse in ex deserunt",
        "brand_id": "a154a7dc-cb13-6802-de97-1b46b56d0117",
        "offline_payments": false,
        "disable_confirmation_email": false,
        "private": false,
        "visibility": "public",
        "minimum_start_date": "1894-05-19T02:23:01.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "888b53b8-d5d6-3e9c-722e-5c0fa7f002ca",
            "membership_type_id": "6695110f-6576-67a1-e9a6-71c73ec16701",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "enim elit labore ea dolor",
              "proident anim in sint",
              "culpa esse dolor quis veniam",
              "nisi do"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1897-02-08T09:53:37.0Z",
            "updated_at": "1916-07-04T03:33:36.0Z"
          },
          {
            "id": "1690db9a-48f7-d985-cd0d-58815fbe99e8",
            "membership_type_id": "eabb36c7-5271-45b8-669d-40efede7a46c",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "anim aute ex adipisicing commodo",
              "in eu tempor laborum",
              "eiusmod",
              "elit",
              "proident non"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1961-05-29T23:31:18.0Z",
            "updated_at": "1956-08-20T11:51:29.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1964-11-13T01:21:27.0Z",
        "updated_at": "1904-04-16T06:27:37.0Z",
        "deleted_at": "1940-03-23T11:57:17.0Z"
      },
      "payment_details_url": "dolor cillum in",
      "created_at": "1938-05-02T01:43:45.0Z"
    },
    {
      "id": "63733abb-a0ec-8687-1849-8fe9c473cf30",
      "attention_reason": "site_id",
      "basket_id": "69de37239035b4015400008b",
      "customer": {
        "id": "241381cc-c7e1-ea9b-f1a6-4eb904edfe7e",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1920-03-07",
        "brand_id": "a484e807-2d1f-7a79-4218-28ad73294436",
        "site_id": "ab29be14-7608-3a02-23c2-67e4a31bdf60",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "cfd3a997-829d-61a7-3ca7-da1894c4cf5f",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "c33b5e41-6229-6e45-1232-1fb18adc8b07",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "39f4eb06-6f36-6e30-6ce1-b2e98649617d",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "88bca09e-85ed-342f-b19b-462649e4ae39",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "ab03c5eb-5268-cdd6-af41-7e0d44dbc23b",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1969-02-13T08:14:57.0Z",
        "created_at": "1909-07-20T22:31:13.0Z",
        "updated_at": "1966-06-25T17:57:36.0Z",
        "deleted_at": "1922-03-29T12:48:05.0Z",
        "last_active_at": "1899-02-05T01:54:36.0Z",
        "email_verified_at": "1906-05-25T07:04:04.0Z",
        "last_check_in": {
          "checked_in_at": "1954-06-16T17:45:48.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "a163d71a-0282-5119-798e-b0339ac8e512",
          "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": "elit exercitation dolor mollit"
      },
      "end_date": "1951-04-18T22:25:49.0Z",
      "external_ref": "eu labore veniam Excepteur cillum",
      "members": [
        {
          "customer_id": "dcf63869-c467-a621-c2e3-179b8d9305dc",
          "is_lead": false,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "8adf9ded-21e7-95cb-1391-67f54803ebe0",
          "is_lead": true,
          "membership_number": "1234567890"
        },
        {
          "customer_id": "002b6864-e908-d969-f443-1c9c619bb25b",
          "is_lead": true,
          "membership_number": "1234567890"
        }
      ],
      "membership_number": "1234567890",
      "next_billing_date": "1910-06-11T08:54:27.0Z",
      "next_charge": {
        "id": "106d0018-b6cd-b96a-8fe1-e04419b22066",
        "amount": 3995,
        "currency": "GBP",
        "status": "awaiting_approval",
        "billing_period_from": "1907-04-09",
        "billing_period_to": "1908-09-08"
      },
      "payment_method": {
        "id": "ea adipisicing in",
        "type": "direct_debit",
        "last_4": "ipsum ea non sunt quis",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "6e5fa004-6db5-0e8b-51d7-0b73e4bcb15d",
        "membership_type_id": "a4096397-732d-6af4-3e3b-11c29912c35c",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "voluptate consequat nulla eiusmod"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1964-05-23T07:29:26.0Z",
        "updated_at": "1911-06-04T04:05:05.0Z"
      },
      "site_id": "0c518822-cee3-f0c0-1334-53fec5bcd0d4",
      "source": "self_signup",
      "start_date": "1969-05-08T16:11:35.0Z",
      "status": "needs_attention",
      "status_updated_at": "1892-05-18T09:17:24.0Z",
      "type": {
        "id": "b3d65a85-8951-10a6-5705-d0e132376fd4",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "occaecat",
        "brand_id": "b89cfa0f-4008-a274-2f13-0cf1bec92d5e",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1924-08-28T03:26:42.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "d1d56dc3-9b9b-28e3-b560-d008d1561c3e",
            "membership_type_id": "a634254e-8ae1-76db-31a7-1962619d6f88",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "consequat dolor",
              "aliquip ex"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1918-07-01T01:46:29.0Z",
            "updated_at": "1926-07-04T21:46:27.0Z"
          },
          {
            "id": "dc35cdf3-8d44-4c2b-6a86-b75eafe4ec02",
            "membership_type_id": "00353aca-5807-ae35-9d12-8d807764e340",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "aliqua ad reprehenderit"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1934-10-12T12:03:06.0Z",
            "updated_at": "1928-02-09T20:14:09.0Z"
          },
          {
            "id": "a6e2a78e-8b04-c511-657b-d446743ecec0",
            "membership_type_id": "8d0f2847-9c5e-0fc5-dd69-c6c0aca9a7e6",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "fugiat tempor sunt commodo voluptate",
              "reprehenderit sint",
              "proident",
              "dolore commodo sit aliqua",
              "tempor"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1965-10-14T21:55:42.0Z",
            "updated_at": "1940-11-07T15:17:27.0Z"
          },
          {
            "id": "f8540732-3b57-0e88-9b04-98774cc5eb1a",
            "membership_type_id": "1f268c09-48b6-c209-7f0d-4601dde59526",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "elit ipsum",
              "tempor nostrud ipsum",
              "et officia Excepteur nulla in",
              "tempor",
              "eiusmod cillum minim elit anim"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1961-05-30T01:18:54.0Z",
            "updated_at": "1921-08-21T11:24:25.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1946-11-07T16:40:17.0Z",
        "updated_at": "1944-05-03T04:42:07.0Z",
        "deleted_at": "1895-09-03T15:48:10.0Z"
      },
      "payment_details_url": "non incididunt",
      "created_at": "1913-03-13T18:41:21.0Z"
    },
    {
      "id": "56590a2a-d441-6dfe-2e73-93e6f1f96b7b",
      "attention_reason": "site_id",
      "basket_id": "69de37239035b4015400008c",
      "customer": {
        "id": "ccd2539b-4959-341d-26db-4fc3c7d074a7",
        "first_name": "Jane",
        "last_name": "Doe",
        "full_name": "Jane Doe",
        "phone": "+447900000000",
        "has_password": true,
        "dob": "1912-08-25",
        "brand_id": "029877fa-dc55-03db-73b3-30292e495da6",
        "site_id": "39740c4c-8eec-78d2-6fed-091a8938ec89",
        "stripe_id": "cus_1234567890",
        "express_stripe_id": "cus_1234567890",
        "email": "janedoe@example.com",
        "labels": [
          {
            "id": "78f863dd-6cab-c5d7-2a40-9049b815c508",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "28dacb80-5ff7-d8af-b4d7-5ccb7da87d91",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "86f9ef96-3502-2b57-ffcd-bd5afbd41ac0",
            "value": "VIP",
            "colour": "ff6634"
          },
          {
            "id": "e0e32cdf-d6cf-1833-73f0-477c833e862d",
            "value": "VIP",
            "colour": "ff6634"
          }
        ],
        "preferred_locale": "en",
        "locked_at": "1903-10-19T01:31:21.0Z",
        "created_at": "1927-06-26T19:19:54.0Z",
        "updated_at": "1943-06-20T01:28:03.0Z",
        "deleted_at": "1939-08-31T16:24:05.0Z",
        "last_active_at": "1964-07-03T23:21:45.0Z",
        "email_verified_at": "1893-07-20T09:56:34.0Z",
        "last_check_in": {
          "checked_in_at": "1931-09-10T08:37:58.0Z",
          "method": "Scanned"
        },
        "avatar_id": "000000-000000-000000-000000",
        "avatar": {
          "id": "3ed4c956-586f-82ac-241e-4261b6d12a01",
          "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": "cillum"
      },
      "end_date": "1949-11-13T06:30:36.0Z",
      "external_ref": "officia ullamco id",
      "members": [],
      "membership_number": "1234567890",
      "next_billing_date": "1919-08-20T12:52:37.0Z",
      "next_charge": {
        "id": "a65fabe8-40a4-0ee1-bbba-c557fb283ebd",
        "amount": 3995,
        "currency": "GBP",
        "status": "errored",
        "billing_period_from": "1960-10-15",
        "billing_period_to": "1940-10-05"
      },
      "payment_method": {
        "id": "esse",
        "type": "direct_debit",
        "last_4": "laboris ut",
        "status": "revoked",
        "card_brand": "amex"
      },
      "rate": {
        "id": "5a0b783f-f56b-1f5a-0d65-aa3e25f103de",
        "membership_type_id": "ffe8a84c-22eb-8dad-b9ce-58574cd4d700",
        "name": "Standard rate",
        "currency": "GBP",
        "price": 5000,
        "joining_fee": 1000,
        "billing_frequency": "P1M",
        "processors": [
          "et",
          "laborum veniam minim Excepteur"
        ],
        "default_duration": "P1Y",
        "private": true,
        "created_at": "1904-10-18T11:08:05.0Z",
        "updated_at": "1966-11-11T18:43:11.0Z"
      },
      "site_id": "00a9a433-6f1f-3543-d64c-4edc85c047f2",
      "source": "self_signup",
      "start_date": "1959-01-05T23:53:53.0Z",
      "status": "upcoming",
      "status_updated_at": "1909-04-27T03:40:49.0Z",
      "type": {
        "id": "86f2907d-6235-abaa-e0a9-2a7f55ec7a76",
        "name": "Gold tier",
        "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
        "terms": "Lorem",
        "brand_id": "87070792-6830-6a2c-4e44-aa816223ffa8",
        "offline_payments": false,
        "disable_confirmation_email": true,
        "private": true,
        "visibility": "link_only",
        "minimum_start_date": "1938-03-09T13:25:06.0Z",
        "min_members": 2,
        "max_members": 4,
        "rates": [
          {
            "id": "2701e950-b133-c6a4-560a-76a34284af07",
            "membership_type_id": "b5f552db-2804-e1fd-adf2-0633bb936dd0",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "sed velit in anim voluptate"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1969-11-17T22:54:59.0Z",
            "updated_at": "1923-02-07T13:44:39.0Z"
          },
          {
            "id": "94002573-4bbc-1ed5-bb0c-5b16a70e0670",
            "membership_type_id": "596f1f0f-589b-4aff-a923-fecd24770868",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1929-12-14T20:09:38.0Z",
            "updated_at": "1895-05-17T06:39:27.0Z"
          },
          {
            "id": "abd74110-9e7f-7341-37e8-25b1d8955672",
            "membership_type_id": "fa1c06d5-2a3f-d582-7ddb-a6e76efb71ae",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "ut pariatur",
              "amet nisi aliqua",
              "Lorem magna",
              "Ut esse",
              "minim"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1952-05-19T17:20:35.0Z",
            "updated_at": "1891-08-25T07:48:14.0Z"
          },
          {
            "id": "8b7cf4f5-c0e8-6d87-cbcb-d097549e305a",
            "membership_type_id": "9dc43839-148d-d283-8dcd-f5f1648a6587",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [
              "labore",
              "aliqua ullamco esse",
              "eu adipisicing",
              "voluptate"
            ],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1910-11-30T15:59:32.0Z",
            "updated_at": "1952-11-26T15:36:08.0Z"
          },
          {
            "id": "fd82d8cc-85cf-82f4-82af-1ea34891accf",
            "membership_type_id": "7616359c-0e5c-5cb5-d430-c3b8e8720071",
            "name": "Standard rate",
            "currency": "GBP",
            "price": 5000,
            "joining_fee": 1000,
            "billing_frequency": "P1M",
            "processors": [],
            "default_duration": "P1Y",
            "private": true,
            "created_at": "1900-02-14T01:54:21.0Z",
            "updated_at": "1940-02-15T01:17:08.0Z"
          }
        ],
        "revenue_schedule": "FREQ=WEEKLY",
        "created_at": "1907-03-20T17:56:55.0Z",
        "updated_at": "1956-07-11T01:50:18.0Z",
        "deleted_at": "1931-08-09T01:55:19.0Z"
      },
      "payment_details_url": "in et reprehenderit consequat",
      "created_at": "1952-11-20T12:56:15.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": "8579c191-0d57-023f-d512-c16d095d88f7",
    "attention_reason": "payment_outstanding",
    "basket_id": "69de37239035b4015400008d",
    "customer": {
      "id": "3cc2c6fe-f918-51e6-514b-6b7be7d8c189",
      "first_name": "Jane",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "phone": "+447900000000",
      "has_password": true,
      "dob": "1969-02-26",
      "brand_id": "6b36cf58-6e99-83e9-5349-1aa754e05603",
      "site_id": "4dcb8026-f850-4588-d5ca-ff8516a7738b",
      "stripe_id": "cus_1234567890",
      "express_stripe_id": "cus_1234567890",
      "email": "janedoe@example.com",
      "labels": [],
      "preferred_locale": "en",
      "locked_at": "1947-09-25T23:20:16.0Z",
      "created_at": "1948-10-31T21:55:11.0Z",
      "updated_at": "1952-11-09T13:01:02.0Z",
      "deleted_at": "1891-07-30T19:32:40.0Z",
      "last_active_at": "1957-08-03T10:42:13.0Z",
      "email_verified_at": "1894-07-11T21:50:12.0Z",
      "last_check_in": {
        "checked_in_at": "1946-01-14T17:51:54.0Z",
        "method": "Scanned"
      },
      "avatar_id": "000000-000000-000000-000000",
      "avatar": {
        "id": "7c90eebd-2467-430f-c32b-594ccebe91d0",
        "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": "occaecat"
    },
    "end_date": "1940-04-17T20:50:32.0Z",
    "external_ref": "quis ut sed",
    "members": [],
    "membership_number": "1234567890",
    "next_billing_date": "1918-11-09T03:24:22.0Z",
    "next_charge": {
      "id": "8e9339cc-caea-7753-598b-45b19d1e84b9",
      "amount": 3995,
      "currency": "GBP",
      "status": "awaiting_approval",
      "billing_period_from": "1942-07-23",
      "billing_period_to": "1902-01-10"
    },
    "payment_method": {
      "id": "dolore ad fugiat aute id",
      "type": "direct_debit",
      "status": "revoked",
      "card_brand": "amex"
    },
    "rate": {
      "id": "1d69b92a-2b76-77a3-c035-7b3eed5b2767",
      "membership_type_id": "96d34eb8-98d4-bae7-6c68-a57cf9a8b111",
      "name": "Standard rate",
      "currency": "GBP",
      "price": 5000,
      "joining_fee": 1000,
      "billing_frequency": "P1M",
      "processors": [
        "eu tempor ut ad",
        "voluptate in",
        "consectetur sunt sed",
        "culpa magna ea amet aute",
        "laboris"
      ],
      "default_duration": "P1Y",
      "private": true,
      "created_at": "1890-07-22T23:42:42.0Z",
      "updated_at": "1943-12-05T11:22:02.0Z"
    },
    "site_id": "a5a52d70-cc80-b78c-715f-04223ad12c05",
    "source": "import",
    "start_date": "1919-07-02T01:38:32.0Z",
    "status": "inactive",
    "status_updated_at": "1960-04-13T19:48:23.0Z",
    "type": {
      "id": "9797ecbe-cdeb-2efc-0cfe-be0417288898",
      "name": "Gold tier",
      "description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
      "terms": "do voluptate proident",
      "brand_id": "8e6cb44b-6693-89e7-4a87-70c3a33554b8",
      "offline_payments": false,
      "disable_confirmation_email": false,
      "private": true,
      "visibility": "link_only",
      "minimum_start_date": "1935-12-18T13:21:20.0Z",
      "min_members": 2,
      "max_members": 4,
      "rates": [
        {
          "id": "0dbec97c-ab00-b2ff-3935-1df7bdf9c23f",
          "membership_type_id": "ca9f8da8-577c-f45b-cec0-0f71124a2336",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "aliquip",
            "et",
            "exercitation dolore in"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1955-04-11T08:27:54.0Z",
          "updated_at": "1895-12-08T01:46:20.0Z"
        },
        {
          "id": "54c36a80-4717-f839-09eb-e6b9fc4fe060",
          "membership_type_id": "148f4877-7378-c1b3-292c-57525a7af33f",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "ipsum pariatur dolor do cupidatat",
            "esse sint dolore aliqua nostrud",
            "sunt dolore",
            "Excepteur",
            "id occaecat ut ea sint"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1928-07-11T20:41:45.0Z",
          "updated_at": "1941-03-04T19:11:18.0Z"
        },
        {
          "id": "29d87407-1785-13a2-8995-d0465b83497d",
          "membership_type_id": "d96891cf-26f8-cc72-bb36-b95367fb95fb",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "est adipisicing"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1898-09-16T08:53:05.0Z",
          "updated_at": "1906-04-02T06:25:13.0Z"
        },
        {
          "id": "fa47860a-8510-5d69-57a8-1ba1848610e1",
          "membership_type_id": "39c77e45-409d-a5e8-78a5-9c0b31fed48f",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1920-08-29T14:16:16.0Z",
          "updated_at": "1920-09-21T05:37:48.0Z"
        },
        {
          "id": "97098dc1-b7af-cce0-0983-f12a549aa289",
          "membership_type_id": "ce64b901-083f-e6aa-4305-92e3247069ad",
          "name": "Standard rate",
          "currency": "GBP",
          "price": 5000,
          "joining_fee": 1000,
          "billing_frequency": "P1M",
          "processors": [
            "laboris id ut",
            "voluptate commodo do",
            "nisi dolore laboris esse ullamco",
            "nisi",
            "consequat"
          ],
          "default_duration": "P1Y",
          "private": true,
          "created_at": "1942-09-28T16:59:15.0Z",
          "updated_at": "1969-05-24T17:17:41.0Z"
        }
      ],
      "revenue_schedule": "FREQ=WEEKLY",
      "created_at": "1966-06-25T01:16:31.0Z",
      "updated_at": "1962-02-14T10:01:57.0Z",
      "deleted_at": "1964-09-21T22:18:26.0Z"
    },
    "payment_details_url": "proident voluptate",
    "created_at": "1926-03-15T21:29:50.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": "44a8f28f-de2b-5a1e-c97a-a030be73164a",
    "membership": {
      "id": "b5514175-d6a6-f50c-977d-821974b87f46",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "94496a7e-6284-dc44-e3db-5ef1da01af3b",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69de37249035b40154000301"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "adipisicing",
    "can_download_receipt": true,
    "amount_refunded": -38832560,
    "refunded": false,
    "refunds": [
      {
        "id": "b20dfb6b-10c1-3a94-554a-bdc334633f96",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "e3e1e5e3-80b6-803b-64b4-d4bdae8df29e",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1893-01-17T20:01:04.0Z",
        "updated_at": "1960-10-20T15:12:02.0Z"
      },
      {
        "id": "f460c226-e245-cc46-5aab-45223c84181b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "114c3359-cd99-ba41-5016-9d2fd63a05ea",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1943-08-10T01:36:08.0Z",
        "updated_at": "1936-05-25T04:12:23.0Z"
      }
    ],
    "site_id": "25ef6e6e-2846-6593-1be9-1650488fd076",
    "billing_period_from": "1907-07-13",
    "billing_period_to": "1944-02-14",
    "processing_at": "1939-09-17T16:35:51.0Z",
    "created_at": "1967-03-26T08:22:50.0Z",
    "updated_at": "1942-11-07T21:46:01.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": "2a347c2c-31ca-9147-e796-83d67c71bf3a",
    "membership": {
      "id": "14b51d6b-d3b2-0e82-602f-a34602f325f3",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "7d1d5faa-16da-ec86-be19-dca8926b18dd"
    },
    "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": "consectetur fugiat ad dolore",
    "can_download_receipt": false,
    "amount_refunded": -13309729,
    "refunded": false,
    "refunds": [],
    "site_id": "f067da80-594b-f565-5e88-9af4f9da7680",
    "billing_period_from": "1911-05-13",
    "billing_period_to": "1934-12-28",
    "processing_at": "1961-10-10T20:08:48.0Z",
    "created_at": "1962-11-12T01:23:49.0Z",
    "updated_at": "1898-06-03T20:25:17.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": "ed7a570a-54eb-c605-69f2-92ecf5232414",
    "membership": {
      "id": "29d669e2-91c5-7c36-fa16-5aecfbe62a70",
      "membership_number": "00000014",
      "type_name": "Gold Membership",
      "customer_id": "332272a3-e551-2656-275d-06bd9c201ee1",
      "customer_name": "Jane Jones"
    },
    "processor": "adyen",
    "processor_data": {
      "cardholder_name": "Mrs J Jones",
      "last_4": 4001,
      "processor_type": "Cash",
      "processor_type_id": "69de37239035b4015400008e"
    },
    "amount": 3995,
    "original_amount": 3995,
    "currency": "gbp",
    "tax": 1000,
    "status": "succeeded",
    "description": "ipsum aliqua minim dolore",
    "can_download_receipt": true,
    "amount_refunded": -16597685,
    "refunded": false,
    "refunds": [
      {
        "id": "5000e188-b639-5afd-170b-4790b9a6b3aa",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "ac2e887c-e89f-1f62-359a-c5ec2f4896ad",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1966-08-09T07:23:11.0Z",
        "updated_at": "1917-10-28T01:25:56.0Z"
      },
      {
        "id": "7fbd6990-a30d-4c19-987f-f0f9feb6b68d",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "c41c4599-9949-d5f8-b046-c5250cff72f9",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1901-06-28T11:06:30.0Z",
        "updated_at": "1951-12-01T16:45:27.0Z"
      },
      {
        "id": "232395d5-7a87-fe10-1cd2-f9916c1e292b",
        "status": "succeeded",
        "amount": 995,
        "currency": "gbp",
        "notes": "Gesture of good will",
        "failure_reason": "invalid_details",
        "refunded_by": {
          "id": "713045c7-a346-4fe1-4a28-14df58c6584a",
          "full_name": "Jane Jenkins"
        },
        "processor_data": {
          "processor": "adyen",
          "processor_id": "re_64301e0b2df9d11814010ea6"
        },
        "created_at": "1931-09-28T01:14:02.0Z",
        "updated_at": "1897-04-13T11:04:51.0Z"
      }
    ],
    "site_id": "8e7b0fc6-b5a4-a679-1aa8-ba4b800c26fa",
    "billing_period_from": "1897-11-11",
    "billing_period_to": "1939-02-08",
    "processing_at": "1961-12-16T04:33:33.0Z",
    "created_at": "1921-10-28T17:30:23.0Z",
    "updated_at": "1950-12-24T08:12:04.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": "69de37249035b40154000302",
    "organisation_id": "73187474-bee1-cd60-e474-a7bb79702dfa",
    "site_id": "4d6bd149-b991-8fe5-95b3-51d8fa7fa07b",
    "customer_id": "afb0fe4d-52f7-0c15-e0bf-ba2be653c7f2",
    "membership_id": "1a102356-425d-a409-e603-cb86d3440438",
    "from": "Trybe",
    "to": "+447123456789",
    "message": "sunt",
    "message_type": "billing_details_request",
    "message_delivered": true,
    "created_at": "2024-02-02T12:01:01.0Z"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}
422
example response
{
  "errors": {
    "nulla3": [
      "aliqua enim sed"
    ]
  },
  "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": "6a5a5907-1b8d-13ff-ebeb-f1c3c8b54671",
    "organisation_id": "d3f44b0f-7b35-2bc3-70a8-9330c2907d81"
  }
}
404
example response
{
  "message": "The requested resource could not be found"
}