TriReg.com Event Director API [BETA]

This API allows you to sign in, and to retrieve event, category, and registration data for your events.

Download a sample client written in VB.NET .

Overview

All requests should be POST requests directed to https://www.TriReg.com/api/director/[MethodName].

Parameters should be supplied in a JSON format, with a content type of "application/json", i.e.

{
  "username": "myusername",
  "password": "mypassword"
}

For legacy reasons, responses are in a escaped JSON format, so depending on your tools, you may need to deserialize twice to get an object you can manipulate. Alternatively, you can also add ?escaped=false to the request to disable this "functionality."

{
            "PromoterLoginResult":"{\"Status\":\"1\", \"promoterID\": \"2547\", \"authToken\":\"5bfda46a-c6d6-4ddc-9eda-4e9ec5138c12\"}"
        }
Some response objects have a lot of fields -- documentation for ones we expect to be relevant to you can be found below.

PromoterLogin

Get an authorization token that you'll need for any other request.
Endpoint: https://www.TriReg.com/api/director/PromoterLogin
Parameter Notes
username Not case-sensitive
password Case sensitive
returns
Status 1 for success, -1 for failure
PromoterID
authToken An authorization token that's good for 24 hours. You'll need to supply a valid token with any other API request.

PromoterEvents

Returns an array of all future events in this event director's account. You will also get events that this director is an additional user on, provided their permissions include ADMIN or DATADOWNLOAD.
Endpoint: https://www.TriReg.com/api/director/PromoterEvents
Parameter Notes
token An authToken value returned from a prior PromoterLogin call.
returns
Event Name
Event ID You'll use this to look up other attributes for this event.

EventCategories

Returns an array of all categories in a given event Endpoint: https://www.TriReg.com/api/director/EventCategories
Parameter Notes
token An authToken value returned from a prior PromoterLogin call.
eventID The event to retrieve categories for.
returns
Category Name
Race ID A unique identifier for this category.
Entry Fee

EventMerchandise

Returns an array of all merchandise in a given event Endpoint: https://www.TriReg.com/api/director/EventMerchandise
Parameter Notes
token An authToken value returned from a prior PromoterLogin call.
eventID The event to retrieve categories for.
returns
Merch Title The name of the merchandise, i.e. "T-shirt"
Merchandise Items An array of sizes or options that are the actual items being selected on the registration page, i.e. "Women's Medium"
Merchandise Item Properties
Merch Price The price of this option
Merch Detail Desc A description of this option, i.e. "Medium"
Merch Detail ID The ID of this merch detail, which will match the RaceID properties of an Entry object when the Entry's transaction type is "Merch"

EventEntries

Returns an all registrations in a given event Endpoint: https://www.TriReg.com/api/director/EventEntries
Parameter Notes
token An authToken value returned from a prior PromoterLogin call.
eventID The event to retrieve entries for.
startDate Optional. A date in Eastern Time to only return entries registered after
endDate Optional. A date in Eastern Time to only return entries registered before
returns
Category Name The category this registration is for
TransactionType Either the string 'Reg' or 'Merch', indicating the type of event item this entry is for
RaceID If the transaction type is 'Reg', this is the RaceID of the category this entry is in.
If the transaction type is 'Merch,' this is the MerchDetailID of the merchandise item this entry is for.
UserInfo A collection of attributes (Name, Team, Address, DOB, Emergency Contact, etc) about this registration.