API Reference

entitlements

2 endpoints

GET/api/v1/organizations/{organization_slug}/members/{user_uuid}/entitlements

Get Member Entitlements

Read a member's active tier and entitlements in an organization.

For third-party gating: an org's backend checks whether one of its users holds a membership/tier/entitlement. A non-member returns is_member=false with empty entitlements.

Path parameters

user_uuid*string
organization_slug*string

Query parameters

default_backendstring

default: "primary"

Responses

200Successful Response
FieldTypeDescription
user_uuid*string
organization_uuid*string
is_member*boolean
tier_uuidstring | null
tier_slugstring | null
entitlementsobject
401Authentication failed
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

403Insufficient permissions
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

404Resource not found
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

422Validation error
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

Example request

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

Check Member Entitlement

Focused check: does the member's active tier grant entitlement key.

Path parameters

user_uuid*string
key*string
organization_slug*string

Query parameters

default_backendstring

default: "primary"

Responses

200Successful Response
FieldTypeDescription
user_uuid*string
organization_uuid*string
key*string
granted*boolean
401Authentication failed
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

403Insufficient permissions
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

404Resource not found
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

422Validation error
FieldTypeDescription
errors*object

Map of field names to error messages. Use '_root' for form-level errors.

message*string

Human-readable error summary

codestring | null

Machine-readable error code

Example request

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