API Documentation: Get Level Information
Endpoint
URL:
https://db.lilacdancecenter.com/api/get_level
Method:
GET
Query Parameters
| Parameter | Type | Description |
|---|---|---|
first_name |
String | The dancer's first name. Required. |
last_name |
String | The dancer's last name. Required. |
Example Request:
https://db.lilacdancecenter.com/api/getlevel?first_name=John&last_name=Doe
Response
The endpoint returns a JSON object containing the dancer's levels for each dance style and their first competition date.
JSON Response Format
{
"smooth_level": "bronze",
"standard_level": "silver",
"rhythm_level": "silver",
"latin_level": "bronze",
"start_date": "2022-03-12T00:00:00.000-05:00",
"level_dates" {
"smooth": {
"newcomer": {
"date": "2022-03-12T00:00:00.000-05:00",
"event_id": 72276,
},
"bronze": { ... },
...
},
"standard": { ... },
...
}
}
Response Parameters
| Field | Type | Description |
|---|---|---|
smooth_level |
String | The level of the dancer in Smooth style (e.g., bronze, silver, etc.). |
standard_level |
String | The level of the dancer in Standard style (e.g., bronze, silver, etc.). |
rhythm_level |
String | The level of the dancer in Rhythm style (e.g., bronze, silver, etc.). |
latin_level |
String | The level of the dancer in Latin style (e.g., bronze, silver, etc.). |
start_date |
Date String | The UTC timestamp of the dancer's first competition in the format YYYY-MM-DDTHH:MM:SS.MS-05:00. Ex: 2022-03-12T00:00:00.000-05:00 |
level_dates |
Nested Dictionary | Contains the dates at which this individual reached a level, per style. Also includes the LilacDB event id that caused the level increase for those curious. Event id use: https://db.lilacdancecenter.com/events?event_id=xxxxx |
Behavior
- The API retrieves the levels associated with the provided dancer's first and last name.
- The
start_datefield corresponds to the date and time of the dancer's first competition.
Example Usage
Request:
GET https://db.lilacdancecenter.com/api/get_level?first_name=Jane&last_name=Doe
Response:
{
"smooth_level": "silver",
"standard_level": "gold",
"rhythm_level": "bronze",
"latin_level": "silver",
"start_date": "2023-06-15T00:00:00.000-05:00",
"level_dates": { ... }
}
This response indicates that:
- The dancer "Jane Doe" has the following dance levels:
- Smooth: Silver
- Standard: Gold
- Rhythm: Bronze
- Latin: Silver
- Their first competition took place on June 15, 2023.
Notes
- Levels are categorized into predefined tiers such as bronze, silver, or gold, as detailed in the MIT Ballroom Dance Team's About YCN Points