API Reference

memberships

10 endpoints

GET/api/v1/organizations/{organization_slug}/memberships

List Memberships

List the organization's members and the tier each holds.

Path parameters

organization_slug*

string

Query parameters

search	string \| null	Search by name, username, or email
default_backend	string	default: "primary"
page	integer	default: 1 · ≥ 1
page_size	integer	default: 20 · ≥ 1 · ≤ 100
sort_by	string \| null
sort_order	string	default: "asc"

Responses

200Successful Response

Field

Type

Description

total_items*

integer

Total number of items available

total_pages*

integer

Total number of pages available

current_page*

integer

Current page number

items*

UserMembershipWithUserResponse[]

List of items on the current page

array items · UserMembershipWithUserResponse

Field

Type

Description

uuid*

string

user_uuid*

string

organization_uuid*

string

tier_uuid*

string

custom_tier_price_cents

integer | null

custom_tier_payment_interval

enum | null

valid_until

string (date-time) | null

created_at*

string (date-time)

updated_at

string (date-time) | null

user*

MemberUserSummary

object · MemberUserSummary

Field	Type	Description
uuid*	string
first_name	string \| null
last_name	string \| null
username	string \| null
email	string \| null
avatar_url	string \| null

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships" \
  -H "Authorization: Bearer <token>"

POST/api/v1/organizations/{organization_slug}/memberships

Join Membership

Enrol a user in one of the organization's membership tiers.

Path parameters

organization_slug*

string

Query parameters

default_backend

string

default: "primary"

Request body*application/json

Field	Type	Description
user_uuid*	string	UUID of the user joining the membership
membership_tier_slug*	string	Slug of the membership tier to join
custom_tier_price_cents	integer \| null	Custom price in cents, if applicable
custom_tier_payment_interval	enum \| null	Custom payment interval, if applicable

Responses

200Successful Response

Field	Type	Description
uuid*	string
user_uuid*	string
organization_uuid*	string
tier_uuid*	string
custom_tier_price_cents	integer \| null
custom_tier_payment_interval	enum \| null
valid_until	string (date-time) \| null
created_at*	string (date-time)
updated_at	string (date-time) \| null

400Invalid request

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

409Resource already exists

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X POST "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ /* request body */ }'

GET/api/v1/organizations/{organization_slug}/memberships/{user_uuid}

Get User Membership

Get one member's active membership.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field

Type

Description

uuid*

string

user_uuid*

string

organization_uuid*

string

tier_uuid*

string

custom_tier_price_cents

integer | null

custom_tier_payment_interval

enum | null

valid_until

string (date-time) | null

created_at*

string (date-time)

updated_at

string (date-time) | null

user*

MemberUserSummary

object · MemberUserSummary

Field	Type	Description
uuid*	string
first_name	string \| null
last_name	string \| null
username	string \| null
email	string \| null
avatar_url	string \| null

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

404Resource not found

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}" \
  -H "Authorization: Bearer <token>"

PATCH/api/v1/organizations/{organization_slug}/memberships/{user_uuid}

Update User Membership

Move a member's active membership to a different tier.

Preserves the join date and history instead of requiring a leave + rejoin, and leaves the existing term (valid_until) alone — use renew to extend that. The tier is the only part of a membership a caller sets directly.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Request body*application/json

Field	Type	Description
membership_tier_slug*	string	Slug of the membership tier to move the member to
custom_tier_price_cents	integer \| null	Custom price in cents for the new tier, if applicable
custom_tier_payment_interval	enum \| null	Custom payment interval for the new tier, if applicable

Responses

200Successful Response

Field	Type	Description
uuid*	string
user_uuid*	string
organization_uuid*	string
tier_uuid*	string
custom_tier_price_cents	integer \| null
custom_tier_payment_interval	enum \| null
valid_until	string (date-time) \| null
created_at*	string (date-time)
updated_at	string (date-time) \| null

400Invalid request

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

404Resource not found

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X PATCH "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ /* request body */ }'

DELETE/api/v1/organizations/{organization_slug}/memberships/{user_uuid}

Leave Membership

Cancel a member's active membership.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field	Type	Description
message*	string	Success or status message

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

404Resource not found

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X DELETE "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}" \
  -H "Authorization: Bearer <token>"

POST/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/renew

Renew Membership

Extend a membership by another term.

The new term is derived from the tier rather than supplied, which is why this is an action and not a field on the membership.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field	Type	Description
uuid*	string
user_uuid*	string
organization_uuid*	string
tier_uuid*	string
custom_tier_price_cents	integer \| null
custom_tier_payment_interval	enum \| null
valid_until	string (date-time) \| null
created_at*	string (date-time)
updated_at	string (date-time) \| null

400Invalid request

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

409Resource already exists

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X POST "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/renew" \
  -H "Authorization: Bearer <token>"

GET/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/wallet

Get Membership Wallet

The wallet holding this membership's balance, with its connection info.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field	Type	Description
wallet_uuid*	string
wallet_address*	string
user_uuid*	string
user_membership_uuid	string \| null
created_at*	string (date-time)

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

404Resource not found

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/wallet" \
  -H "Authorization: Bearer <token>"

GET/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/history

Get Membership History

Every membership record this user has held here, cancelled ones included.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field

Type

Description

total_items*

integer

Total number of items available

total_pages*

integer

Total number of pages available

current_page*

integer

Current page number

items*

UserMembershipHistoryResponse[]

List of items on the current page

array items · UserMembershipHistoryResponse

Field	Type	Description
uuid*	string
user_uuid*	string
organization_uuid*	string
tier_uuid*	string
custom_tier_price_cents	integer \| null
custom_tier_payment_interval	enum \| null
valid_until	string (date-time) \| null
joined_at*	string (date-time)
deleted_at	string (date-time) \| null
status*	enum
created_at*	string (date-time)
updated_at	string (date-time) \| null
tier_name*	string
tier_slug*	string

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/history" \
  -H "Authorization: Bearer <token>"

GET/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/cards

Get Membership Cards

Cards linked to this membership's wallet.

Freezing one goes through the organization's card endpoints, which address the same cards by uuid.

Path parameters

user_uuid*	string
organization_slug*	string

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field

Type

Description

total_items*

integer

Total number of items available

total_pages*

integer

Total number of pages available

current_page*

integer

Current page number

items*

MembershipCardResponse[]

List of items on the current page

array items · MembershipCardResponse

Field	Type	Description
card_uuid*	string
identifier*	string
card_type*	enum
is_frozen*	boolean
created_at*	string (date-time)
updated_at	string (date-time) \| null

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/organizations/{organization_slug}/memberships/{user_uuid}/cards" \
  -H "Authorization: Bearer <token>"

GET/api/v1/memberships

List Memberships

Get all active memberships for the current user across all organizations.

Returns membership details including organization name and tier information.

For org-scoped tokens, filters to only memberships in the scoped organization.

Query parameters

default_backend

string

default: "primary"

Responses

200Successful Response

Field

Type

Description

total_items*

integer

Total number of items available

total_pages*

integer

Total number of pages available

current_page*

integer

Current page number

items*

UserMembershipWithOrgResponse[]

List of items on the current page

array items · UserMembershipWithOrgResponse

Field	Type	Description
uuid*	string
user_uuid*	string
organization_uuid*	string
tier_uuid*	string
custom_tier_price_cents	integer \| null
custom_tier_payment_interval	enum \| null
valid_until	string (date-time) \| null
joined_at*	string (date-time)
created_at*	string (date-time)
updated_at	string (date-time) \| null
organization_name*	string
organization_slug*	string
tier_name*	string
tier_slug*	string

401Authentication failed

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

403Insufficient permissions

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

422Validation error

Field	Type	Description
errors*	object	Map of field names to error messages. Use '_root' for form-level errors.
message*	string	Human-readable error summary
code	string \| null	Machine-readable error code

Example request

curl -X GET "https://api.davi.social/api/v1/memberships" \
  -H "Authorization: Bearer <token>"