A Membership represents a membership belonging to one or more Customers.
The ID of the membership
The ID of the site this membership belongs to
membership_numberThe 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.
Possible values are active, needs_dd_mandate, needs_attention, reserved, inactive, expired and upcoming
Where the membership was created
Possible values are self_signup, app, import and unknown
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 date which the membership starts
The date which the membership ends
The datetime which the membership was created
The basket ID which was used to purchase this membership, if applicable.
An external reference for this membership.
The date which the membership will next be billed
next_chargeA 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.
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
""listMembershipsThis endpoint lists the Memberships which are associated to the provided site.
The Memberships were successfully retrieved
{
"data": [
{
"site_id": "6986872e-786e-102e-5ce4-3f1f5ac19a72",
"members": [
{
"customer_id": "8dcdd6d5-e0b7-f6ee-b0d1-7057583c7b26",
"membership_number": "1234567890"
},
{
"customer_id": "4bb45301-9af9-abfd-1166-d570225ca714",
"membership_number": "1234567890",
"is_lead": true
},
{
"customer_id": "31f9dabb-6a51-f4be-0ac0-fd43e7752c29",
"membership_number": "1234567890",
"is_lead": false
}
],
"rate": {
"id": "38e41dc1-d353-5688-6a3a-2e948f34621f",
"membership_type_id": "aa717fba-5f58-2ea8-6e5a-e391fd25b3b5",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"joining_fee": 1000,
"tax": 1250,
"billing_frequency": "P1M",
"processors": [
"qui eu aliqua aliquip Lorem",
"mollit aliqua reprehenderit minim"
],
"default_duration": "P1Y",
"private": true,
"created_at": "1904-04-03T17:57:21.0Z"
},
"external_ref": "minim occaecat id exercitation"
},
{
"membership_number": "1234567890",
"customer": {
"id": "99c783cb-e4d2-66d3-4f2d-52af619a7075",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"phone": "+447900000000",
"has_password": true,
"dob": "1966-08-21",
"brand_id": "89e1f618-edae-64e8-8bda-f9483d3ad8f8",
"site_id": "7c22c642-e44d-c66c-594f-7f9d8bf1c481",
"stripe_id": "cus_1234567890",
"express_stripe_id": "cus_1234567890",
"email": "janedoe@example.com",
"labels": [
{
"id": "abb586c0-4c6c-bd2b-6708-ef4e6fb94755",
"name": "VIP",
"color": "ff6634"
},
{
"id": "1843db34-46bf-2308-99bd-881012debb17",
"name": "VIP",
"color": "ff6634"
}
],
"preferred_locale": "en",
"locked_at": "1935-06-04T18:22:05.0Z",
"created_at": "1926-02-01T15:34:55.0Z",
"updated_at": "1929-03-25T09:49:05.0Z",
"deleted_at": "1922-12-16T12:31:01.0Z",
"last_active_at": "1967-05-10T01:17:53.0Z",
"email_verified_at": "1953-12-26T02:07:33.0Z",
"last_check_in": {
"checked_in_at": "1892-08-26T15:29:44.0Z",
"method": "Scanned"
},
"avatar_id": "000000-000000-000000-000000",
"avatar": {
"id": "a74ec97d-4c27-e0d8-42ee-f74f47afe6d0",
"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": "Excepteur proident qui"
},
"members": [
{
"customer_id": "71f5913d-593b-1da4-0b59-7c10ac20f144",
"membership_number": "1234567890",
"is_lead": true
},
{
"customer_id": "3464f956-a4a8-4be3-8919-c5f78b6b9379",
"membership_number": "1234567890"
},
{
"membership_number": "1234567890",
"is_lead": false
}
],
"type": {
"id": "08261409-a5ed-629e-b80d-3da2d8cf4dbd",
"name": "Gold tier",
"description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
"terms": "sunt",
"brand_id": "de3596eb-308a-bd55-2026-c2746e510816",
"offline_payments": false,
"disable_confirmation_email": true,
"private": true,
"visibility": "link_only",
"minimum_start_date": "1946-10-06T11:39:35.0Z",
"min_members": 2,
"max_members": 4,
"rates": [
{
"name": "Standard rate",
"price": 5000
},
{
"id": "42132380-b31e-5ec7-668c-389cdfbd042d",
"membership_type_id": "8ae35e8d-e2e9-4c0a-2b3e-7eca82e919a6",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"joining_fee": 1000,
"private": true
}
],
"revenue_schedule": "FREQ=WEEKLY",
"created_at": "1944-07-29T11:16:02.0Z",
"updated_at": "1906-08-23T02:43:26.0Z",
"deleted_at": "1940-10-05T06:02:35.0Z"
},
"status": "upcoming",
"source": "unknown",
"payment_method": {
"id": "eu dolore aliquip proident",
"type": "direct_debit",
"last_4": "aute in dolor",
"status": "revoked",
"card_brand": "amex"
},
"start_date": "1933-01-10T12:45:29.0Z",
"end_date": "1912-02-05T05:06:52.0Z",
"created_at": "1907-12-04T09:42:12.0Z",
"basket_id": "69413703ad973e0157000071",
"next_billing_date": "1950-07-27T07:37:45.0Z",
"next_charge": {
"id": "186a839c-d760-c1d8-0370-76231485d64e",
"amount": 3995,
"currency": "GBP",
"status": "processing",
"billing_period_from": "1936-04-22",
"billing_period_to": "1893-01-26"
},
"attention_reason": "no_mandate"
},
{
"id": "a4864135-62ca-020d-a3dc-337a252d73d8",
"site_id": "76c81c34-93c8-3b0a-bee6-e18f5208c1bb",
"membership_number": "1234567890",
"customer": {
"id": "774036e8-4d6f-dcdc-711a-67bc5489ff60",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"phone": "+447900000000",
"has_password": true,
"dob": "1897-12-26",
"brand_id": "c5032ad8-14fb-6cd6-5618-c23ea1939c76",
"site_id": "573ce7cc-51da-c64e-4087-ebcfede15104",
"stripe_id": "cus_1234567890",
"express_stripe_id": "cus_1234567890",
"email": "janedoe@example.com",
"labels": [
{
"id": "a92a92d1-90f1-7ff6-e28d-4117b5683ae1",
"name": "VIP",
"color": "ff6634"
},
{
"id": "98572005-c884-745c-79da-3d9356ca6b32",
"name": "VIP",
"color": "ff6634"
},
{
"id": "25808c86-a3ee-a0d6-7057-9f2c2fb1dcde",
"name": "VIP",
"color": "ff6634"
},
{
"id": "1db3102f-b905-7221-2fb7-d05072db5a34",
"name": "VIP",
"color": "ff6634"
}
],
"preferred_locale": "en",
"locked_at": "1927-06-27T07:39:36.0Z",
"created_at": "1948-02-18T12:13:22.0Z",
"updated_at": "1956-08-12T01:55:47.0Z",
"deleted_at": "1913-08-26T12:50:13.0Z",
"last_active_at": "1898-04-05T15:01:20.0Z",
"email_verified_at": "1964-10-10T17:58:21.0Z",
"last_check_in": {
"checked_in_at": "1956-05-30T09:38:52.0Z",
"method": "Scanned"
},
"avatar_id": "000000-000000-000000-000000",
"avatar": {
"id": "4b0891f9-84ad-38b8-d2d3-084696834976",
"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": "veniam nulla dolor minim"
},
"members": [
{
"is_lead": true
},
{
"customer_id": "88b7e233-3870-643b-02eb-00c808024477",
"membership_number": "1234567890",
"is_lead": false
},
{
"customer_id": "84e3e3fd-5851-b8a9-8aed-b056c9475eac"
}
],
"type": {
"id": "3a342470-b362-07a2-c219-ff4ac5e9ab12",
"name": "Gold tier",
"description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
"terms": "ullamco eu qui eiusmod nisi",
"brand_id": "e60ebfbd-f5c5-c536-880e-3df9a850ccd2",
"offline_payments": false,
"disable_confirmation_email": false,
"private": false,
"visibility": "link_only",
"minimum_start_date": "1965-12-04T22:03:50.0Z",
"min_members": 2,
"max_members": 4,
"rates": [
{
"id": "397116f8-5e0a-4041-0124-60e358e0df93",
"membership_type_id": "ee62a388-def9-5726-b793-d1020a826ce9",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"processors": [
"deserunt in proident occaecat",
"amet ex est enim mollit",
"elit velit",
"consectetur sed ut"
],
"default_duration": "P1Y"
},
{
"id": "1f63b653-b533-70af-a543-f50c9721d9a3",
"membership_type_id": "69d24097-03b0-e2af-049d-840b177e9564",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"joining_fee": 1000,
"tax": 1250,
"billing_frequency": "P1M",
"processors": [],
"private": true,
"created_at": "1962-07-03T01:30:33.0Z",
"updated_at": "1906-09-09T06:56:18.0Z"
},
{
"id": "dead4b73-ada6-fc7c-1062-9f255b020553",
"membership_type_id": "6cdc25c9-4dc0-141d-4a40-14f7e11da36d",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"joining_fee": 1000,
"tax": 1250,
"billing_frequency": "P1M",
"default_duration": "P1Y",
"private": true,
"created_at": "1922-06-18T22:16:40.0Z",
"updated_at": "1964-10-22T22:57:07.0Z"
},
{
"id": "a5a7f5e9-8941-7c98-707f-1715e867b9cf",
"membership_type_id": "a207c1c7-c9e0-fd74-84de-fcdaae4eb727",
"name": "Standard rate",
"currency": "GBP",
"updated_at": "1962-12-28T06:41:31.0Z"
}
],
"revenue_schedule": "FREQ=WEEKLY",
"created_at": "1907-08-26T06:47:30.0Z",
"updated_at": "1934-12-24T20:17:57.0Z",
"deleted_at": "1919-10-11T23:26:21.0Z"
},
"rate": {
"id": "8a25a215-558e-af06-e05b-e60873ba059f",
"membership_type_id": "ac7d4ea7-e59a-9f5d-f1d1-fd58bfc07128",
"name": "Standard rate",
"currency": "GBP",
"price": 5000,
"joining_fee": 1000,
"tax": 1250,
"billing_frequency": "P1M",
"processors": [],
"default_duration": "P1Y",
"private": true,
"created_at": "1901-02-20T04:41:35.0Z"
},
"status": "inactive",
"source": "import",
"payment_method": {
"id": "et quis cillum reprehenderit irure",
"type": "card",
"last_4": "Duis qui anim et",
"status": "revoked"
},
"start_date": "1967-12-12T23:49:46.0Z",
"end_date": "1908-05-09T07:06:13.0Z",
"created_at": "1937-08-30T10:42:12.0Z",
"basket_id": "69413703ad973e0157000072",
"external_ref": "pariatur commodo",
"next_charge": {
"id": "57e28a3a-f284-79d7-bc6a-9323d214123d",
"amount": 3995,
"currency": "GBP",
"status": "succeeded",
"billing_period_from": "1933-12-29",
"billing_period_to": "1938-10-11"
}
}
],
"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"
}
}getMembershipUse this endpoint to retrieve a Membership by its ID.
membershipIdThe ID of the membership
{
"data": {
"id": "5871f23b-3c8c-4ce3-a01d-f22e031ba4a5",
"membership_number": "1234567890",
"customer": {
"id": "6535a090-543b-7b6d-62a1-d758da6bf9c7",
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"phone": "+447900000000",
"has_password": true,
"dob": "1927-03-12",
"brand_id": "a654883e-5e6a-a3a6-dd18-280554afb24d",
"site_id": "9ce4de99-613d-a5db-1cb8-3ce40f0ab693",
"stripe_id": "cus_1234567890",
"express_stripe_id": "cus_1234567890",
"email": "janedoe@example.com",
"labels": [
{
"id": "a244d205-480d-eca3-001b-153bec8b9218",
"name": "VIP",
"color": "ff6634"
},
{
"id": "5d10e862-d556-25fb-6405-58c596da5154",
"name": "VIP",
"color": "ff6634"
},
{
"id": "94ed505e-e382-5a59-f517-e5119eff4532",
"name": "VIP",
"color": "ff6634"
}
],
"preferred_locale": "en",
"locked_at": "1937-09-28T13:41:32.0Z",
"created_at": "1914-05-16T02:01:06.0Z",
"updated_at": "1947-12-01T08:25:32.0Z",
"deleted_at": "1953-03-17T22:46:03.0Z",
"last_active_at": "1945-10-29T04:13:37.0Z",
"email_verified_at": "1963-02-11T06:11:34.0Z",
"last_check_in": {
"checked_in_at": "1930-08-29T14:40:41.0Z",
"method": "Scanned"
},
"avatar_id": "000000-000000-000000-000000",
"avatar": {
"id": "ce96880f-5559-3abf-3bd7-6840db8be44f",
"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 laborum aute elit"
},
"members": [
{
"customer_id": "13bd5a05-722e-cef3-b585-34c5ac6f4ed3",
"membership_number": "1234567890",
"is_lead": false
},
{
"customer_id": "3c540ee8-cc93-f669-dc40-57a72f350679"
},
{
"is_lead": false
},
{
"membership_number": "1234567890"
}
],
"type": {
"id": "afc45b46-842a-736c-75c1-0b68a74d3afc",
"name": "Gold tier",
"description": "Enjoy exclusive benefits as part of being a member in our Gold tier",
"terms": "esse",
"brand_id": "e8df931d-0c72-8535-4b55-7d3745055756",
"offline_payments": false,
"disable_confirmation_email": false,
"private": true,
"visibility": "public",
"minimum_start_date": "1934-05-02T20:11:26.0Z",
"min_members": 2,
"max_members": 4,
"rates": [],
"revenue_schedule": "FREQ=WEEKLY",
"created_at": "1946-09-21T21:25:49.0Z",
"updated_at": "1917-05-05T21:06:32.0Z",
"deleted_at": "1906-05-10T23:36:13.0Z"
},
"rate": {
"id": "932c5ebc-0d55-c874-10ae-73a7fc574be5",
"price": 5000,
"tax": 1250,
"private": true,
"updated_at": "1899-08-28T06:10:04.0Z"
},
"start_date": "1959-09-28T03:51:41.0Z",
"created_at": "1965-11-18T08:03:07.0Z",
"basket_id": "69413703ad973e0157000073",
"external_ref": "Lorem labore",
"next_charge": {
"id": "28b3675c-efd6-6009-383f-d76be5149774",
"amount": 3995,
"currency": "GBP",
"status": "succeeded",
"billing_period_from": "1915-04-07",
"billing_period_to": "1913-02-03"
},
"attention_reason": "payment_disputed"
}
}{
"message": "The requested resource could not be found"
}actionAddMembershipChargePaymentThis endpoint allows a manual (off-Trybe) payment to be recorded against a membership charge.
chargeIdThe ID of the charge
payment_type_idThe ID of the custom payment type this payment should be recorded as
amountThe amount of the payment
{
"data": {
"id": "01d79392-b678-ffd6-c080-f338487e1f4f",
"membership": {
"id": "931f4d95-ff1c-d7a3-ed6b-ad1e647aaf81",
"membership_number": "00000014",
"type_name": "Gold Membership",
"customer_id": "58677f88-c46b-f49e-3030-bd6eaec9eb1e",
"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": "pariatur ullamco sint adipisicing",
"can_download_receipt": true,
"amount_refunded": "laboris ut",
"refunded": "aliqua",
"refunds": [
{
"id": "949d6a54-8e4f-9315-c602-037a6951a99d",
"status": "succeeded",
"amount": 995,
"currency": "gbp",
"notes": "Gesture of good will",
"failure_reason": "invalid_details",
"refunded_by": {
"id": "5ba1a547-858d-f26f-d3e0-ef0973ab091d",
"full_name": "Jane Jenkins"
},
"processor_data": {
"processor": "adyen",
"processor_id": "re_64301e0b2df9d11814010ea6"
},
"created_at": "1958-03-20T11:40:46.0Z",
"updated_at": "1945-07-28T14:24:43.0Z"
},
{
"id": "cf0bcdd8-5f88-e5a5-80ce-4bffbc95d049",
"status": "succeeded",
"amount": 995,
"currency": "gbp",
"notes": "Gesture of good will",
"processor_data": {
"processor": "adyen",
"processor_id": "re_64301e0b2df9d11814010ea6"
},
"created_at": "1951-05-19T18:21:39.0Z",
"updated_at": "1965-02-02T06:01:58.0Z"
},
{
"id": "c0bf9869-372d-b813-a829-e5f622613f50",
"status": "succeeded",
"amount": 995,
"currency": "gbp",
"notes": "Gesture of good will",
"failure_reason": "invalid_details",
"refunded_by": {
"id": "f1a4602e-d47b-8a3a-b2bc-0b069b7ecc36",
"full_name": "Jane Jenkins"
},
"processor_data": {
"processor": "adyen",
"processor_id": "re_64301e0b2df9d11814010ea6"
},
"created_at": "1967-12-30T01:43:04.0Z",
"updated_at": "1957-08-01T14:19:54.0Z"
}
],
"site_id": "cee92fa7-2908-2bd7-4616-facfd2a076ee",
"billing_period_from": "1960-08-31",
"billing_period_to": "1931-06-18",
"processing_at": "1945-11-29T21:29:11.0Z",
"created_at": "1909-03-05T19:36:29.0Z",
"updated_at": "1954-10-29T19:25:52.0Z"
}
}{
"message": "The requested resource could not be found"
}actionProcessMembershipChargeThis endpoint allows a membership charge to be processed manually.
chargeIdThe ID of the charge
{
"data": {
"id": "10b7c4c2-f22d-1853-03c7-acc706baff6c",
"membership": {
"id": "778badc2-4acc-d3da-db25-6c95113ee60c",
"membership_number": "00000014",
"type_name": "Gold Membership",
"customer_id": "97161f2a-f525-6ba0-7694-181879c135d9",
"customer_name": "Jane Jones"
},
"processor": "adyen",
"processor_data": {
"cardholder_name": "Mrs J Jones",
"processor_type_id": "69413703ad973e0157000074"
},
"amount": 3995,
"original_amount": 3995,
"currency": "gbp",
"tax": 1000,
"status": "succeeded",
"description": "anim",
"can_download_receipt": true,
"amount_refunded": "exercitation dolore est sunt incididunt",
"refunded": "aute aliquip labore dolore irure",
"refunds": [],
"site_id": "06e362c5-305c-c7ca-78e9-ae8fa5b44aa7",
"billing_period_from": "1927-06-10",
"billing_period_to": "1945-10-10",
"processing_at": "1896-03-17T12:18:43.0Z",
"created_at": "1920-02-18T11:08:21.0Z",
"updated_at": "1924-02-25T01:43:13.0Z"
}
}{
"message": "The requested resource could not be found"
}actionRetryMembershipChargeThis endpoint allows a membership charge to be retried manually.
chargeIdThe ID of the charge
{
"data": {
"id": "fa715314-ed6a-1550-26ad-0dcef6416196",
"membership": {
"id": "3cc36589-4a70-3a62-b025-5705afb20562",
"membership_number": "00000014",
"type_name": "Gold Membership",
"customer_id": "90e68944-b1d5-1d7b-89ab-31ddda32ff90",
"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": "ipsum sunt ea mollit",
"can_download_receipt": false,
"amount_refunded": "ullamco anim veniam",
"refunded": "dolor pariatur Lorem",
"refunds": [
{
"id": "6b2bed40-97ed-f65a-1400-ecc2852b1fff",
"status": "succeeded",
"amount": 995,
"currency": "gbp",
"notes": "Gesture of good will",
"failure_reason": "invalid_details",
"refunded_by": {
"id": "4af096b9-7a60-fb45-8426-1804c2ca8e06",
"full_name": "Jane Jenkins"
},
"processor_data": {
"processor": "adyen",
"processor_id": "re_64301e0b2df9d11814010ea6"
},
"created_at": "1910-07-28T03:03:26.0Z",
"updated_at": "1902-06-11T01:01:16.0Z"
},
{
"id": "d0c22cff-1e72-c88c-48f5-dcb890e2ad3a",
"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": "1903-02-15T06:10:30.0Z",
"updated_at": "1954-03-08T03:17:10.0Z"
},
{
"id": "d1314200-c524-bdb9-19a3-e28d2f11691f",
"status": "succeeded",
"amount": 995,
"currency": "gbp",
"notes": "Gesture of good will",
"failure_reason": "invalid_details",
"refunded_by": {
"id": "b45a44ae-3d41-ae77-d750-85e6b3829eaf",
"full_name": "Jane Jenkins"
},
"processor_data": {
"processor": "adyen",
"processor_id": "re_64301e0b2df9d11814010ea6"
},
"created_at": "1906-01-23T14:52:43.0Z",
"updated_at": "1940-09-15T15:38:47.0Z"
}
],
"site_id": "f95fad5b-633c-dd10-785a-2d5a1b58d555",
"billing_period_from": "1914-01-22",
"billing_period_to": "1947-07-03",
"processing_at": "1894-10-23T03:28:34.0Z",
"created_at": "1921-05-15T09:17:27.0Z",
"updated_at": "1896-09-04T16:25:34.0Z"
}
}{
"message": "The requested resource could not be found"
}