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

EventEntries

Returns an all registrations in a given event Endpoint: https://www.RunReg.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
RaceID	The Race ID for this registration's category.
UserInfo	A collection of attributes (Name, Team, Address, DOB, Emergency Contact, etc) about this registration.