Endpoint reference

Search events

@wodira/browser.searchEventsList public events from the frontend@wodira/sdk.searchEventsSearch events from a backend

Browser API

POST /external/v1/browser/events/search
x-publishable-key: wpk_live_...

{ "search": "Madrid", "limit": 20, "offset": 0 }

Organizer API

POST /external/v1/organizer/events/search
Authorization: Bearer wd_live_...

Also supports status filters when the secret key has the events:read scope.

Event details

@wodira/browser.getEventPublic event detail@wodira/sdk.getEventFull server-to-server event detail

GET /external/v1/browser/events/event_123
x-publishable-key: wpk_live_...

GET /external/v1/organizer/events/event_123
Authorization: Bearer wd_live_...

Pricing cards

@wodira/browser.getPricingCardsPublic categories and prices@wodira/sdk.getPricingCardsCategories, quotas, and prices from a backend

GET /external/v1/browser/events/event_123/pricing-cards
x-publishable-key: wpk_live_...

Returns categories, quotas, registrations, base price, active price, and tiers.

GET /external/v1/organizer/events/event_123/pricing-cards
Authorization: Bearer wd_live_...

Checkout summary

@wodira/browser.getRegistrationSummaryReactive summary before payment

POST /external/v1/browser/checkout/registration/summary
x-publishable-key: wpk_live_...

{
  "categoryId": "cat_123",
  "purchaserEmail": "buyer@example.com",
  "selectedSupplementIds": ["supp_123"],
  "promocode": "EARLY"
}

Checkout session

@wodira/browser.createRegistrationCheckoutSessionCreate a Stripe Checkout Session

POST /external/v1/browser/checkout/registration/session
x-publishable-key: wpk_live_...

{
  "eventId": "event_123",
  "categoryId": "cat_123",
  "purchaserEmail": "buyer@example.com",
  "purchaserName": "Buyer Name",
  "teamName": "Team Name",
  "termsAccepted": true,
  "waiversAccepted": { "waiver_123": true },
  "idempotencyKey": "checkout_123",
  "successUrl": "https://organizer.com/success",
  "cancelUrl": "https://organizer.com/cancel",
  "athletes": [
    {
      "fullname": "Ada Lovelace",
      "email": "ada@example.com",
      "phone": "+34600000000",
      "idNumber": "12345678A",
      "gender": "FEMALE",
      "birthDate": "1990-01-01"
    }
  ]
}

The response includes sessionId and sessionUrl; redirect to sessionUrl to open Stripe Checkout.

Server-to-server registrations

Use the Organizer API only from a backend.

@wodira/sdk.createRegistrationCreate a registration@wodira/sdk.searchRegistrationsSearch registrations@wodira/sdk.updateRegistrationUpdate a registration@wodira/sdk.deleteRegistrationCancel/delete a registration

Method	Full path	Scope
POST	/external/v1/organizer/registrations	registrations:write
POST	/external/v1/organizer/registrations/search	registrations:read
PATCH	/external/v1/organizer/registrations/:ticketId	registrations:write
DELETE	/external/v1/organizer/registrations/:ticketId	registrations:write