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_date field 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