API Reference · v1

Build on Praeva

Clean REST endpoints, OpenAPI 3.1 specced, webhooks, and signed payloads. Designed for production.

v1.4.2

99.99% uptime

Authentication

All requests use bearer token authentication. Keys are scoped per environment.

curl https://api.praeva.club/v1/members \
  -H "Authorization: Bearer prv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane@example.com",
    "name": "Jane Doe",
    "referrer_code": "ELEANOR-7X4K",
    "consent": { "marketing": true, "policy_version": "2026-01" }
  }'

200 OK · application/json

{
  "id": "mem_01HZK9...",
  "email": "jane@example.com",
  "name": "Jane Doe",
  "status": "Founding",
  "referral_code": "JANE-9F2P",
  "referrer_id": "mem_01HZ8E...",
  "created_at": "2026-06-23T10:14:22Z"
}

Members

POST/v1/membersCreate a new member account

GET/v1/members/:idRetrieve a member by ID

PATCH/v1/members/:idUpdate a member's profile

GET/v1/membersList & search members

Referrals

POST/v1/referralsRegister a referral event

GET/v1/referrals/:codeLook up a referral code

GET/v1/members/:id/referralsList a member's referral activity

Rules

POST/v1/rules/tiersUpdate tier thresholds

GET/v1/rules/tiersRead current tier configuration

Marketplace

GET/v1/listingsList marketplace opportunities

POST/v1/listingsCreate a new listing

PATCH/v1/listings/:idUpdate a listing

DELETE/v1/listings/:idArchive a listing

POST/v1/leadsSubmit an inquiry on a listing

Webhooks

POST/v1/webhooksRegister an outbound webhook

Exports

POST/v1/exports/:datasetRequest a data export

Audit

GET/v1/auditStream audit events

Errors

Code	Status	Meaning
400	Bad Request	Invalid payload
401	Unauthorized	Missing or invalid API key
403	Forbidden	Insufficient scope
404	Not Found	Resource does not exist
409	Conflict	Duplicate referral / email
429	Rate limited	Too many requests