Get All Scans

get

https://api.swoogo.com/api/v1/scans/sessions

Retrieves all session check-in scan records for an event. Scans are created when a registrant's badge or QR code is scanned at a session entrance, providing a timestamped record of physical check-in. Requires the event_id query parameter.

Query Params

event_id

integer

required

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

session_id

string

integer - optional - Optionally see only the scans for one session

registrant_id

string

integer - optional - The ID of the registrant the scan is associated with

fields

string

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

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)

string

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

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

Language

Credentials

Bearer

access_token

URL

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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.