Get All Discount Codes

get

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

Retrieves all discount codes for a specific event. Discount codes can be percentage-based, absolute (fixed amount), or specific (custom fees per line item). Requires the event_id query parameter. Use expand to include alternates, autopopulate field mappings, registrantCount, or reservedCount.

Available Fields

These are the standard fields available for configuring a discount code:

Name	Type	Description
`id`	integer	The ID of the discount code.
`code`	string	The unique code for the discount.
`type`	string	The type of discount: percentage, absolute, or specific.
`percentage_discount`	number	The percentage value of the discount (if applicable).
`absolute_discount`	number	The absolute monetary value of the discount (if applicable).
`applicable_line_items`	array	Array of items to which the discount applies.
`apply_to_all`	boolean	Indicates if the discount applies to all items.
`capacity`	integer	The maximum number of times this discount can be used.
`min_group_size`	integer	The minimum group size required to use this discount.
`registrants_per_use`	integer	The maximum number of registrants that can use this discount per group.
`all_registrants_in_group`	boolean	Whether all registrants in a group must use the same discount.
`custom_fees`	array	Custom fees associated with this discount.
`notes`	string	Additional notes or comments about the discount.
`event_id`	integer	The ID of the event to which this discount is associated.
`created_at`	string (date-time)	Timestamp when the discount was created.
`updated_at`	string (date-time)	Timestamp when the discount was last updated.
`is_sold_out`	boolean	Indicates if the discount is sold out based on capacity.

Extra Fields

This is the extra information that can be returned if required by specifying what you need in the expand variable:

Name	Type	Description
`alternates`	object	Alternative code list, which will inherit the settings of the main code
`autopopulate`	object	Registrant fields to be automatically populated with the specified data, when this discount code is applied to a registrant.
`registrantCount`	integer	Number of registrants that used this Discount Code.
`reservedCount`	integer	Number of reserved Discount Codes.

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 pages 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.