Skip to main content

API Documentation: Get PPS Information

Endpoint

URL:

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

Method:
GET

Query Parameters

Parameter Type Description
first_nameprofile_idIntegerThe profile_id of user the token belogs to. Required
token String The dancer'user's first name.tokens. Required.
last_namecomp_id StringInteger TheComp dancer'sID lastthat name.the Required.user wants PPS data for. Only for /pps_events

Example Request:

https://db.lilacdancecenter.com/api/get_preferred_name?first_name=Johnpps_comps?profile_id=1&last_name=Doetoken=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 thePPS dancer'sdata preferred name, pronouns, and pronunciation, along within their profile link iffor the userrequested had set it to publiccompetition.

JSON Response Format

/pps_comps
{
  "Matthew Emerick"1187":
    {
      "preferred_name"id":1187,
      "abbreviation":"Matt"ifb26",
      "pronunciation"comp_date":"2026-05-16T00:00:00.000-04:00",
      "location":"",
      # empty string if not set
      "pronouns"name":"He/Him/His"Island Fantasy Ball (32nd year 2026",
      "profile_link"source":"https://db.lilacdancecenter.com/profiles/1"o2cm",
      "entry_count":171,
      "competitor_count":94
    },
    ...
}
/pps_events
  This is in the format requested by USA Dance.
Back to top