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

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.

badges

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

Queryable
name
badge_number
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.

days

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

discounts

The Discounts allowed to be used when buying a Badge based upon this badge type.

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.

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
 }