Membership (v1-2025-04-18)

The Membership API provides all the capabilities for managing your membership. Although it is most commonly used to look up the membership information for a single contact or organization, it can also be used to approve, modify, or drop members.

Like most of the other Rhythm apps, the Membership API includes endpoints for Query Definitions. These endpoints are commonly used to retrieve saved queries, which can then be executed using the Query endpoints of the System API.

Download OpenAPI description
Languages
Servers
Mock server
https://docs.api.rhythmsoftware.com/_mock/apis/membership/membership-v1/
https://membership.api.rhythmsoftware.com/

Add On Products

Add On Products

Operations

Add On Types

Add On Types

Operations

Add Ons

Add Ons

Operations

App Reference Types

App Reference Types

Operations

Application Groups

Application Groups

Operations

Application Processes

Application Processes

Operations

Application Status Reasons

Application Status Reasons

Operations

Applications

Applications

Operations

Ballots

Ballots

Operations

Billing Notices

Billing Notices

Operations

Billing Run Actions

Billing Run Actions

Operations

Billing Runs

Billing Runs

Operations

Billing Templates

Billing Templates

Operations

Change Fees

Change Fees

Operations

Chapter Dues Products

Chapter Dues Products

Operations

Chapter Types

Chapter Types

Operations

Chapters

Chapters

Operations

Coupons

Coupons

Operations

Directories

Directories

Operations

Elections

Elections

Operations

Group Application Processes

Group Application Processes

Operations

Id Card Templates

Id Card Templates

Operations

Memberships

Memberships

Operations

Generates snapshot lookback for a tenant

Request

Given a set of expiration options, allows for the calculation of an expiration date

Path
tenantIdstringrequired

The id of the tenant being accessed.

curl -i -X POST \
  'https://docs.api.rhythmsoftware.com/_mock/apis/membership/membership-v1/memberships/{tenantId}/initiateSnapshotLookback' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Date was calculated successfully

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
string
Response
application/json
"string"

Returns a list of records with the specified order_id

Request

Returns a list of records with the specified order_id

Path
tenantIdstringrequired

The tenant

order_idstringrequired

The order_id to use to for record lookup

Query
fieldsstring

The fields that you want to retrieve; if omitted, the entire object is returned

exclusiveStartKeystring

If paging, this allows you to return the next set of results

curl -i -X GET \
  'https://docs.api.rhythmsoftware.com/_mock/apis/membership/membership-v1/memberships/{tenantId}/order/{order_id}?exclusiveStartKey=string&fields=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

The records were retrieved successfully

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
Countinteger
ItemsArray of objects(Membership)
LastEvaluatedKeystring
Response
application/json
{ "Count": 0, "Items": [ {} ], "LastEvaluatedKey": "string" }

Gets a membership by organization

Request

Gets a membership by organization

Path
tenantIdstringrequired

The id of the tenant being accessed.

organizationIdstringrequired

The organization id

curl -i -X GET \
  'https://docs.api.rhythmsoftware.com/_mock/apis/membership/membership-v1/memberships/{tenantId}/organization/{organizationId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

The members was retrieved successfully

Headers
Access-Control-Allow-Headersstring
Access-Control-Allow-Methodsstring
Access-Control-Allow-Originstring
Bodyapplication/json
add_on_idsArray of strings(Add Ons)

used for reporting, DO NOT UPLOAD DATA HERE

add_on_namesstring(Add On Names)

Read only: Show the name of the add ons to this membership

add_onsArray of objects
application_idstring(Application)

The last application

application_process_idstring(Application Process)

The last application process

assigned_membershipsArray of objects

Memberships that have been assigned, manually, by organization administrators

bill_methodstring(Bill Method)

The method this member was billed

Enum"auto renewal order""renewal notice""renewal order"
bill_organizationboolean(Bill Organization)

Whether or not to bill the organization for this membership

billedboolean(Billed)

Flag indicated whether the membership has been billed

certificate_uristring(Certificate Uri)

A link to an externally created certificate of membership

chapter_idsArray of strings(Chapter IDs)

used for reporting, DO NOT UPLOAD DATA HERE

chapter_namesstring(Chapter Names)

Read only: Show the name of the chapters to which a person belongs

chaptersArray of objects
citystring(City)

The member city

contact_idstring(Contact)required

The owner of this membership

countrystring(Country)

The member country

custom_field_valuesArray of objects(Custom Field Values)
customer_idstring(Customer)

For reporting only; the contact ID if this is owned by a contact, the organization if this is owned by an organization

date_last_updated_in_portalstring(date-time)(Date Last Updated In Portal)

The date that this was last updated in the portal

date_statusstring(Date Status)

Whether the dates have been updated

Enum"not yet updated""updated"
directory_image_uristring(Directory Image Uri)

The image that appears in the membership directory

do_not_dropboolean(Do Not Drop)

If set, this membership will not be dropped/terminated along lifecycle rules

do_not_renewboolean(Do Not Renew)

If so, this membership will not renew

do_not_show_in_directoryboolean(Do Not Show In Directory)

If set, the membership is not available in the directory

email_addressstring(Email Address)

The member's email address

expiration_datestring(Expiration Date)

The date the membership expires

first_namestring(First Name)

The member's first name

flowdown_depthnumber(float)(Flowdown Depth)[ 1 .. 10 ]required

If this is a flow down membership, the depth

hidden_directory_fieldsArray of strings(Hidden Directory Fields)

The fields that should not be shown for this member in the directory

historyArray of objects

The history of membership events & activities

idstring(ID)^[\w-|:]+$required

The unique, string identifier of this membership

is_newboolean(Is New)

Whether or not this is a new membership

job_titlestring(Job Title)

The member job title

join_datestring(Join Date)

The date the member joined

join_or_last_renewal_datestring(Join Or Last Renewal Date)

The date the member joined OR renewed

lapse_datestring(Lapse Date)

The last date that this record was terminated. Unlike termination date does not get erased

last_bill_datestring(date-time)(Last Bill Date)

The last time this order was billed

last_change_affiliation_datestring(date-time)(Last Change Affiliation Date)

The last date a change affiliation was run on this membership

last_expired_card_warningnumber(float)(Last Expired Card Warning)

The last expired card warning

last_expired_card_warning_datestring(date-time)(Last Expired Card Warning Date)

The last time a reminder was sent

last_namestring(Last Name)

The member's last name

last_remindernumber(float)(Last Reminder)

The last reminder number

last_reminder_datestring(date-time)(Last Reminder Date)

The last time a reminder was sent

master_membership_idstring(Master Membership)

The master organizational membership that generates the flowdown; when depth=1 this is the same as the parent, but supports cascading membership

master_membership_organization_idstring(Master Membership Organization)

The master organization that owns the membership; when depth=1 this is the same as the parent, but supports cascading membership

membership_join_datestring(Membership Join Date)

Reporting only; used to avoid collisions

namestring(Name)required

The member's name

notesstring(Notes)
numbernumber(float)(Number)required

The unique membership number

order_amount_paidnumber(double)(Order Amount Paid)

The amount paid

order_balance_duenumber(double)(Order Balance Due)

The balance due on the order

order_currency_codestring(Order Currency Code)
order_currency_symbolstring(Order Currency Symbol)
order_idstring(Order)

The order

order_line_item_idstring(Order Line Item)

The order line item

order_numbernumber(float)(Order Number)

The order number

order_statusstring(Order Status)
Enum"awaiting payment""awaiting pickup""awaiting shipping""cancelled""completed""disputed""open""partially shipped""returned""shipped"
order_totalnumber(double)(Order Total)

The total of the order

organization_idstring(Organization)required

The organizational owner of this membership

originstring(Origin)
Enum"assigned""flowdown""principal"
overridden_fieldsArray of strings(Overridden Fields)

Fields that have been changed on this record, and should not be susceptible to flowdown

owner_typestring(Owner Type)required

The type of owner

Enum"contact""organization"
package_idstring(Package)required

The package id of the membership

parent_membership_idstring(Parent Membership)organization:.*required

The parent organization

past_chapter_membershipsArray of objects
past_section_membershipsArray of objects
primary_chapter_idstring(Primary Chapter)

The chapter ID (used for reporting, DO NOT UPLOAD DATA HERE

referral_contact_idstring(Referral Contact)

The individual who referred this member

reinstatement_datestring(Reinstatement Date)

The date the member was last reinstated

renew_automaticallyboolean(Renew Automatically)

If set, then this membership will automatically renew with the card on file

renewal_currency_codestring(Renewal Currency Code)

The currency code to use for renewal

Enum"AED""AFN""ALL""AMD""ANG""AOA""ARS""AUD""AWG""AZN"
renewal_datestring(Renewal Date)

The date the member last renewed

renewal_payment_card_expirationstring(date)(Renewal Payment Card Expiration)

The date that the renewal payment card expires

renewal_payment_infoobject(Renewal Payment Info)required

The renewal payment info

renewal_payment_info.​card_expirationstring(Card Expiration)

The expiration date of the card

renewal_payment_info.​card_typestring(Card Type)

The type of card being used, or CHECK if electronic check

Enum"american express""discover""electronic check""mastercard""other""visa"
renewal_payment_info.​merchant_account_tokensArray of objectsnon-empty
renewal_payment_info.​payment_accountstring(Payment Account)

The masked payment account information

renewal_payment_info.​payment_originstring(Payment Origin)required

Whether or not this is a saved payment method

Enum"ad hoc""saved""single token"
renewal_payment_info.​tokenstring(Token)

For integrated payments, the single token

renewal_payment_info.​typestring(Type)required

The type of payment

Enum"credit card""electronic check"
section_idsArray of strings(Section IDs)

used for reporting, DO NOT UPLOAD DATA HERE

section_namesstring(Section Names)

Read only: Show the name of the sections to which a person belongs

sectionsArray of objects
statestring(State)

The state

statusstring(Status)

The member status

Enum"active""active without benefits""inactive""suspended"
status_reason_idstring(Status Reason)

The reason that a member is in the specific status

sys_bulk_load_atstring(Sys Bulk Load At)

If this record was loaded via bulk, the timestamp when the record was processed

sys_bulk_load_idstring(Sys Bulk Load)

If this record was loaded via bulk, the ID of the bulk load process

sys_bulk_load_pkstring(Sys Bulk Load Pk)

If this record was loaded via bulk, the tenant and key of the bulk load process used as a partition key

sys_bulk_load_record_nonumber(float)(Sys Bulk Load Record No)

If this record was loaded via bulk, the record number in the source file

sys_bulk_load_source_filestring(Sys Bulk Load Source File)

If this record was loaded via bulk, the source file

sys_calculated_field_errorstring(Sys Calculated Field Error)

The error associated with the calculated field

sys_calculated_field_errorsArray of objects
sys_configuration_snapshot_idstring(Sys Configuration Snapshot)

If a snapshot was restored/applies to this record, the ID of the snapshot

sys_created_atstring(date-time)(Sys Created At)required

The date/time that this record was created, expressed in ISO-8601 date format

sys_created_by_idstring(Sys Created By)required

The ID of the user that created this record

sys_deleted_by_idstring(Sys Deleted By)

The ID of the user that deleted (or last tried to delete) this object

sys_directivestring(Sys Directive)

Means for passing directive information into an object processing logic

sys_external_idstring(Sys External)

The ID that a record has from an external system or data import

sys_has_files_in_s3boolean(Sys Has Files In S3)

If true, this record has files in S3. If false, it doesnt, so no need to hit S3 upon deletion

sys_last_bulk_data_operation_idstring(Sys Last Bulk Data Operation)

If this record was last touched by a bulk data operation, the ID of that operation

sys_last_bulk_data_operation_sys_versionstring(Sys Last Bulk Data Operation Sys Version)

If this record was last touched by a bulk data operation, the sys_version at the time of that operation

sys_last_modified_atstring(date-time)(Sys Last Modified At)required

The date/time that this record record was last modified, expressed in ISO-8601 date format

sys_last_modified_by_idstring(Sys Last Modified By)required

The ID of the user that last modified this record

sys_last_security_contextobject(Sys Last Security Context)

The security context of the last insert, modify, or delete performed on this item

sys_lockedboolean(Sys Locked)

If set, this record is locked and cannot be changed via the API

sys_snapshot_base_versionnumber(float)(Sys Snapshot Base Version)

The version to use as a base when creating a configuration snapshot; if not set, 1 is used. Helpful when creating a sandbox

sys_versionnumber(float)(Sys Version)

A number representing the version of this record in the database

term_start_datestring(Term Start Date)

The date the most recently purchased membership type starts

termination_datestring(Termination Date)

The date the member was terminated

type_idstring(Type)required

The type of member

Response
application/json
{ "add_on_ids": [ "string" ], "add_on_names": "string", "add_ons": [ {} ], "application_id": "string", "application_process_id": "string", "assigned_memberships": [ {} ], "bill_method": "auto renewal order", "bill_organization": true, "billed": true, "certificate_uri": "string", "chapter_ids": [ "string" ], "chapter_names": "string", "chapters": [ {} ], "city": "string", "contact_id": "string", "country": "string", "custom_field_values": [ {} ], "customer_id": "string", "date_last_updated_in_portal": "2019-08-24T14:15:22Z", "date_status": "not yet updated", "directory_image_uri": "string", "do_not_drop": true, "do_not_renew": true, "do_not_show_in_directory": true, "email_address": "string", "expiration_date": "string", "first_name": "string", "flowdown_depth": 1, "hidden_directory_fields": [ "string" ], "history": [ {} ], "id": "string", "is_new": true, "job_title": "string", "join_date": "string", "join_or_last_renewal_date": "string", "lapse_date": "string", "last_bill_date": "2019-08-24T14:15:22Z", "last_change_affiliation_date": "2019-08-24T14:15:22Z", "last_expired_card_warning": 0.1, "last_expired_card_warning_date": "2019-08-24T14:15:22Z", "last_name": "string", "last_reminder": 0.1, "last_reminder_date": "2019-08-24T14:15:22Z", "master_membership_id": "string", "master_membership_organization_id": "string", "membership_join_date": "string", "name": "string", "notes": "string", "number": 0.1, "order_amount_paid": 0.1, "order_balance_due": 0.1, "order_currency_code": "string", "order_currency_symbol": "string", "order_id": "string", "order_line_item_id": "string", "order_number": 0.1, "order_status": "awaiting payment", "order_total": 0.1, "organization_id": "string", "origin": "assigned", "overridden_fields": [ "string" ], "owner_type": "contact", "package_id": "string", "parent_membership_id": "string", "past_chapter_memberships": [ {} ], "past_section_memberships": [ {} ], "primary_chapter_id": "string", "referral_contact_id": "string", "reinstatement_date": "string", "renew_automatically": true, "renewal_currency_code": "AED", "renewal_date": "string", "renewal_payment_card_expiration": "2019-08-24", "renewal_payment_info": { "card_expiration": "string", "card_type": "american express", "merchant_account_tokens": [], "payment_account": "string", "payment_origin": "ad hoc", "token": "string", "type": "credit card" }, "section_ids": [ "string" ], "section_names": "string", "sections": [ {} ], "state": "string", "status": "active", "status_reason_id": "string", "sys_bulk_load_at": "string", "sys_bulk_load_id": "string", "sys_bulk_load_pk": "string", "sys_bulk_load_record_no": 0.1, "sys_bulk_load_source_file": "string", "sys_calculated_field_error": "string", "sys_calculated_field_errors": [ {} ], "sys_configuration_snapshot_id": "string", "sys_created_at": "2019-08-24T14:15:22Z", "sys_created_by_id": "string", "sys_deleted_by_id": "string", "sys_directive": "string", "sys_external_id": "string", "sys_has_files_in_s3": true, "sys_last_bulk_data_operation_id": "string", "sys_last_bulk_data_operation_sys_version": "string", "sys_last_modified_at": "2019-08-24T14:15:22Z", "sys_last_modified_by_id": "string", "sys_last_security_context": {}, "sys_locked": true, "sys_snapshot_base_version": 0.1, "sys_version": 0.1, "term_start_date": "string", "termination_date": "string", "type_id": "string" }

Packages

Packages

Operations

Query Definitions

Query Definitions

Operations

Recurring Billing Runs

Recurring Billing Runs

Operations

Section Dues Products

Section Dues Products

Operations

Section Types

Section Types

Operations

Sections

Sections

Operations

Settings

Settings

Operations

Statistics

Statistics

Operations

Status Reasons

Status Reasons

Operations

Types

Types

Operations