Skip to main content
All CollectionsPrivate Labeling, API, etc.
Real-time scoring over an API
Real-time scoring over an API

Importing scores over an API

Michael avatar
Written by Michael
Updated over a week ago

If you are working with an external system that captures scores such as a chip or an aquatics timing system. You can quickly process scores into Competition Corner through a simple API connection.


The originating system

  • must have the capability of delivering data over an API (if not check out this article, Importing Scores)

  • at minimum, it must deliver 2 required data points a participant ID and the results

  • if scores are captured in time, the data must be in the following format HH:MM:SS.000

This is what a typical output would look like from your originating system in a JSON format:

"First Name": "Lexi",
"Last Name": "DeSaracho",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "524658",
"CGID": "1236",
"Time": "00:13:37.2"
"First Name": "Allison",
"Last Name": "McClellan",
"Gender": "Female",
"Team Name": "",
"CompCornerID": "527182",
"CGID": "1245",
"Time": "00:13:59.1"

Setting up your connection

  • Go to Scoring Setup, click the API Integration tab, click +

  • Select your workout

  • Map your data points

  • Establish the frequency of pulling data from the source API


You provide should have the capability to provide you with a simulation to ensure you've established a successful connection.

A quick way to test is copy an existing workout and replicate the same API settings. Once you've confirmed scores have been processed successfully, simply delete the test workout.

Scoring Amendments

It's very important that a score that is adjusted, happens at the source.

If a score is changed directly in Competition Corner, it will likely be overwritten by the API unless you've disabled the API for that specific workout.

Considerations for Team events

Competition Corner will only accept 1 score per Team, this is important to consider how you chip your teams. There are 2 approaches:

  • Use 1 chip per team

  • Use a chip for every team member on the team

If you are chipping every team member on a team, you will need to process the total team score before it is imported into Competition Corner.

It is also important that you verify that each team mates scores are accounted for to avoid a partial teams score appear faster than a complete team score after you process their totals.

Related Articles

Did this answer your question?