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