Skip to main content

API Documentation: Get Level Information

Endpoint

URL:

https://db.lilacdancecenter.com/api/getlevelget_level

Method:
GET

Query Parameters

Parameter Type Description
firstNamefirst_name String The dancer's first name. Required.
lastNamelast_name String The dancer's last name. Required.
majorityIntegerRequested majority of dances for leveling up. Optional.

Example Request:

https://db.lilacdancecenter.com/api/getlevel?firstName=first_name=John&lastName=last_name=Doe

https://db.lilacdancecenter.com/api/getlevel?firstName=John&lastName=Doe&majority=3

Response

The endpoint returns a JSON object containing the dancer's levels for each dance style and their first competition date.

JSON Response Format

{
  "smoothLevel"smooth_level": "bronze",
  "standardLevel"standard_level": "silver",
  "rhythmLevel"rhythm_level": "silver",
  "latinLevel"latin_level": "bronze",
  "startDate"start_date": "2024-10-192022-03-12T00:00:00.000-05:00",
  "level_dates" {
    "smooth": {
      "newcomer": {
        "date": "2022-03-12T00:00:00:0000.000-05:00",
        UTC""event_id": 72276,
        },
      "bronze": { ... },
      ...
    },
    "standard": { ... },
    ...
  } 
}

Response Parameters

Field Type Description
smoothLevelsmooth_level String The level of the dancer in Smooth style (e.g., bronze, silver, etc.).
standardLevelstandard_level String The level of the dancer in Standard style (e.g., bronze, silver, etc.).
rhythmLevelrhythm_level String The level of the dancer in Rhythm style (e.g., bronze, silver, etc.).
latinLevellatin_level String The level of the dancer in Latin style (e.g., bronze, silver, etc.).
startDatestart_date Date String The UTC timestamp of the dancer's first competition in the format YYYY-MM-DD HH:DDTHH:MM:SS UTCSS.MS-05:00. 
Ex: 2022-03-12T00:00:00.000-05:00
level_datesNested DictionaryContains 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 startDatestart_date field corresponds to the date and time of the dancer's first competition, stored in UTC format..

Example Usage

Request:

GET https://db.lilacdancecenter.com/api/getlevel?firstName=get_level?first_name=Jane&lastName=last_name=Doe

Response:

{
  "smoothLevel"smooth_level": "silver",
  "standardLevel"standard_level": "gold",
  "rhythmLevel"rhythm_level": "bronze",
  "latinLevel"latin_level": "silver",
  "startDate"start_date": "2023-06-1515T00:00:00.000-05:00",
  00:00:00"level_dates": UTC"{ ... }
}

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

  • Ensure that both firstName and lastName parameters are provided; otherwise, the API will not return a valid response.
  • The first and last name of the dancer must have proper capitalization.
  • Levels are categorized into predefined tiers such as bronze, silver, or gold, as detailed in the MIT Ballroom Dance Team's About YCN Points
Back to top