Badge Type

Configuration of the various Badges people will ultimately purchase. You'll need the registration ConventionPrivilege to edit these. Badge Types are accessed via /api/badgetype.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in BadgeTypeProperties. It also has these extra read-only properties:

available_count

The number of badges of this badge type that are still available for sale.

Related Objects

See "Related Objects" in Introduction for how to use them.

badgetypecategory

BadgeTypeCategory is a relationship that allows the grouping of like badge types together.

convention

The Convention this badgetype belongs to.

Relationships

See "Relationships" in Introduction for how to use them.

badges

The list of Badges that have been created for this badge type.

Queryable
badge_number
firstname
lastname
Qualifiers
badgetype_id
checked_in
verified

badgetypecondays

BadgeTypeConDays manage the relationship between badge types and ConventionDays.

badgetypediscounts

BadgeTypeDiscounts manage the relationship between badge types and Discounts.

badgetypeproducts

BadgeTypeProducts manage the relationship between badge types and complimentary Products.

boothtypes

If using the exhibitor management system, then BoothTypes may give away a certain quantity of free badges and they'll select which badge type to give away.

complimentary_products

The Products complimentary with a badge of this badge type.

days

The ConventionDays this badge is allowed to enter the convention, and buy Tickets for if ticketing is enabled.

discounts

The Discounts usable when buying a Badge based upon this badge type. (Associated via "badgetypediscounts".)

Queryable
discount.name
discount.description
Qualifiers
discount.enabled
discount.public

eventgroupbadgetypes

EventGroupBadgeTypes manage the relationship between badge types and EventGroups.

Queryable
eventgroup.name
Qualifiers
eventgroup.limit_by_badge_type

eventgroups

If ticketing is enabled and event groups are enabled then this is the list of EventGroups that this badge type has access to buy events for.

shiftbadgetypes

If the convention is set to require Volunteers to have a Badge for the same day they want to volunteer, ShiftBadgeTypes manage the relationship between Shifts and their supporting badge types.

sponsorships

The list of Sponsorships offering complimentary badges of this badge type.

Services

The services used to fetch and manipulate badgetypes.

Search Badge Types

This will search across all conventions. To search on a single convention see "Relationships" in Convention.

 GET /api/badgetype
Optional Params
query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "Weekend Badge",
          ...
        },
        ...
    ]
 }

Create Badge Type

 POST /api/badgetype
Required Params
session_id
convention_id
name

Returns the same as a normal read.

Read Badge Type

 GET /api/badgetype/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "Weekend Badge",
   ...
 }

Update BadgeType

 PUT /api/badgetype/xxx

Returns the same as a normal read.

Delete BadgeType

 DELETE /api/badgetype/xxx

Returns:

 {
   "success" : 1
 }

Available Complimentary Products

Gets the badge type's complimentary products, if any, but limited to those still available. See "complimentary_products".

 GET /api/badgetype/xxx/complimentary_products/available

Returns the same as a normal read from "complimentary_products".