Overview

Memberships let you offer group subscriptions where one owner pays for multiple members. The owner handles all billing and controls who has access. Members share the same entitlements as the owner but never see invoices or payment details.

When the owner cancels or their subscription expires, all members immediately lose access.

How It Works

Owner subscribes - A customer purchases a membership plan with a specified number of seats
Owner adds members - The owner invites people by email, or configures automatic access by IP address or email domain
Members get access - Invited members register or log in to activate their access

Example: A university library purchases a 500-seat subscription. They configure their campus IP range (128.112.0.0/16) for automatic access. Students on campus get access without logging in. The library can also invite specific researchers by email for off-campus access.

API Endpoints

Method	Endpoint	Description
`GET`	`/api/v1/core/memberships`	List all members in your account
`POST`	`/api/v1/core/memberships`	Add a member to a subscription
`GET`	`/api/v1/core/memberships/{id}`	Get details for a specific member
`PUT`	`/api/v1/core/memberships/{id}`	Update a member's details
`DELETE`	`/api/v1/core/memberships/{id}`	Remove a member from a subscription
`POST`	`/api/v1/core/memberships/invite`	Send an email invitation to a new member
`POST`	`/api/v1/core/memberships/ip/authorization`	Check if an IP address has access

Member Statuses

Status	What It Means
`pending`	Invitation sent, waiting for the member to register or log in
`active`	Member has access to the subscription's entitlements

Membership Object

Attribute	Type	Description
`id`	integer	Unique identifier for the membership
`user_id`	integer	ID of the member (expandable)
`subscription_id`	integer	ID of the parent subscription (expandable)
`site_id`	integer	ID of the site
`address_id`	integer	ID of the member's address
`status`	string	Membership status: `pending` or `active`
`created_at`	timestamp	Unix timestamp of creation
`updated_at`	timestamp	Unix timestamp of last update

Related Endpoints

IP Authorization - Check if an IP address is authorized for access