API Documentation

• API Documentation: Get Level Information
• API Documentation: Get Preferred Name, Pronouns, Pronunciation
• API Documentation: Get PPS Information

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

API Documentation: Get Preferred Name, Pronouns, Pronunciation

Endpoint

URL:

db.lilacdancecenter.com/api/get_preferred_name

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/get_preferred_name?first_name=John&last_name=Doe

---

Response

The endpoint returns a JSON object containing the dancer's preferred name, pronouns, and pronunciation, along within their profile link if the user had set it to public

JSON Response Format

{
  "Matthew Emerick":
    {
      "preferred_name":"Matt",
      "pronunciation":"", # empty string if not set
      "pronouns":"He/Him/His",
      "profile_link":"https://db.lilacdancecenter.com/profiles/1"
      }
}

API Documentation: Get PPS Information

Endpoint

URL:

https://db.lilacdancecenter.com/api/pps_comps
https://db.lilacdancecenter.com/api/pps_events

Method:
GET

---

Query Parameters

Parameter	Type	Description
profile_id	Integer	The profile_id of user the token belogs to. Required
token	String	The user's tokens. Required.
comp_id	Integer	Comp ID that the user wants PPS data for. Only for /pps_events

Example Request:

https://db.lilacdancecenter.com/api/pps_comps?profile_id=1&token=ThisIsAnAPIToken

https://db.lilacdancecenter.com/api/pps_events?profile_id=1&token=ThisIsAnAPIToken&comp_id=1178

---

Response

/pps_comps

The endpoint returns a JSON object of competition data from the beginning of the previous year (e.g. since 01-01-2025 assuming today is during 2026)

/pps_events

The endpoint returns a JSON object containing PPS data for the requested competition.

JSON Response Format

/pps_comps

{
  "1187":
    {
      "id":1187,
      "abbreviation":"ifb26",
      "comp_date":"2026-05-16T00:00:00.000-04:00",
      "location":"",
      "name":"Island Fantasy Ball (32nd year 2026",
      "source":"o2cm",
      "entry_count":171,
      "competitor_count":94
    },
    ...
}

/pps_events

  This is in the format requested by USA Dance.