Get All Registrants

get

https://api.swoogo.com/api/v1/registrants

Retrieves a paginated list of registrants for a specific event. Returns registrant profile data, registration status, and financial summaries.

Requires event_id as a query parameter. Use fields to control which fields are returned (defaults to id, first_name, last_name when not specified). Use expand to include related address objects: homeAddress, workAddress, billingAddress.

Use search to filter by any registrant field (e.g., registration_status=confirmed, email=*@example.com*). Supports operators: =, !=, >=, <=, >, <, *contains*, *beginswith*, *endswith*. Maximum 200 results per page with per-page, or up to 1000 per page when no expand is used.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

event_id

integer

required

integer - required - The ID of the event you want to retrieve registrants for

fields

string

string - optional - Comma separated list of fields you want to return

expand

string

string - optional - Comma separated list of objects you want to return

string

string - optional - Filter conditions to narrow the results. Valid operators are =, !=, >=, <=, >, <, contains, beginswith, endswith

page

string

integer - optional - The page of results you want to view

per-page

string

integer - optional - The number of results per page (to a max of 200)

sort

string

string - optional - Sort the results (add - in front for opposite sort direction, e.g. "-id")

ids

string

Comma-separated list of IDs to retrieve. When provided, only records matching these IDs are returned. All values must be positive integers. Maximum 100 IDs per request.

Responses

200Collection

401Authentication failed. The bearer token is missing, expired, or invalid. Obtain a new token via POST /oauth2/token.

403The authenticated user does not have permission to access this resource. This can occur if the resource belongs to a different account or the API credentials lack the required scope.

404The specified resource does not exist or has been deleted. Verify the ID is correct and that the resource belongs to an event your credentials have access to.

500An unexpected server error occurred. If this persists, contact Swoogo support with the request details and timestamp.