Get All Packages

curl --request GET \
  --url https://api.swoogo.com/api/v1/packages \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": 1,
      "name": "Gold Package",
      "public_short_name": "Gold",
      "admin_short_name": "Gold",
      "description": "Full conference access including dinner.",
      "capacity": 100,
      "sold_out_message": "Sold Out",
      "min_group_size": null,
      "max_group_size": null,
      "created_at": "2023-04-21 15:46:23",
      "updated_at": "2023-04-21 15:47:37",
      "fees": {
        "id": 42,
        "package_id": 1,
        "price": 199,
        "conditional_prices": {
          "Standard": "149.00"
        }
      },
      "earlyBirds": {
        "type": "date",
        "price": 149,
        "registrations": 50,
        "items": [
          {
            "price": 149,
            "date": "2024-03-01 00:00:00",
            "conditional_fees": {
              "Standard": "129.00"
            }
          }
        ]
      },
      "translations": {
        "en": {
          "name": "Gold Package"
        },
        "fr": {
          "name": "Forfait Or"
        }
      }
    }
  ],
  "_links": {
    "self": {
      "href": ""
    },
    "first": {
      "href": ""
    },
    "last": {
      "href": ""
    }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 25
  }
}

Packages

Get All Packages

Retrieves all registration packages (pricing tiers) for a specific event. Packages define the pricing structure that registrants select during registration, including capacity limits and group size constraints. Requires the event_id query parameter.

When the fields query parameter is omitted, the response only includes id, name, and capacity for each package. To retrieve additional fields, list them explicitly in fields. Use expand to include related objects such as fee pricing or translations.

Soft-deleted packages are excluded from the results. Results default to the package sort order ascending unless overridden with the sort parameter.

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
`fees`	object	Fee record for this package, including base price and any conditional pricing.
`earlyBirds`	object	Early-bird pricing configuration for this package’s fee. Contains a `type` string and either a flat `price`/`registrations` pair (registrations-based) or an `items` array of date-based tiers.
`translations`	object	Custom translations for this package, keyed by language code (e.g. `en`, `fr`). Each value is an object of field name → translated string.

GET

packages

Get All Packages

curl --request GET \
  --url https://api.swoogo.com/api/v1/packages \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "id": 1,
      "name": "Gold Package",
      "public_short_name": "Gold",
      "admin_short_name": "Gold",
      "description": "Full conference access including dinner.",
      "capacity": 100,
      "sold_out_message": "Sold Out",
      "min_group_size": null,
      "max_group_size": null,
      "created_at": "2023-04-21 15:46:23",
      "updated_at": "2023-04-21 15:47:37",
      "fees": {
        "id": 42,
        "package_id": 1,
        "price": 199,
        "conditional_prices": {
          "Standard": "149.00"
        }
      },
      "earlyBirds": {
        "type": "date",
        "price": 149,
        "registrations": 50,
        "items": [
          {
            "price": 149,
            "date": "2024-03-01 00:00:00",
            "conditional_fees": {
              "Standard": "129.00"
            }
          }
        ]
      },
      "translations": {
        "en": {
          "name": "Gold Package"
        },
        "fr": {
          "name": "Forfait Or"
        }
      }
    }
  ],
  "_links": {
    "self": {
      "href": ""
    },
    "first": {
      "href": ""
    },
    "last": {
      "href": ""
    }
  },
  "_meta": {
    "totalCount": 1,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 25
  }
}

Authorizations

Authorization

string

header

required

OAuth 2.0 bearer token obtained from POST /oauth2/token. Tokens expire after 30 minutes. Include in the Authorization header as Bearer {access_token}.

Query Parameters

event_id

integer

required

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

Example:

1

fields

string

string - optional - Comma separated list of fields you want to return. When omitted, only id, name, and capacity are returned.

Example:

"id,name,public_short_name,admin_short_name,description,capacity,sold_out_message,min_group_size,max_group_size,created_at,updated_at"

expand

string

string - optional - Comma separated list of related objects to embed in each item. Supported values are fees, earlyBirds, and translations.

Example:

"fees"

string

string - optional - Filter conditions to narrow the results. Valid operators are =, !=, >=, <=, >, <, contains, beginswith, endswith. Searchable fields are id, name, public_short_name, admin_short_name, description, capacity, min_group_size, max_group_size, created_at, and updated_at.

Example:

"id>123"

searchCondition

enum<string>

default:and

string - optional - Logical operator used to combine multiple search conditions. Defaults to and (all conditions must match). Set to or for any-match behavior.

Available options:

and,

or

page

string

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

Example:

"1"

per-page

string

integer - optional - The number of results per page. Defaults to 25. Maximum is 200 when expand is present.

Example:

"5"

sort

string

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

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.

Response

Collection

items

object[]

Show child attributes

_links

object

Show child attributes

_meta

object

Show child attributes

Overview

Get One Package

⌘I