PediTools 2022 Bilirubin Guidelines Free API Access

The PediTools 2022 AAP hyperbilirubinemia guidelines clinical decision support tool can be called as an API endpoint, for automated access via, for example, an Electronic Health Record.

The API is free to use, without requirements for registration or licensing. No advertisements will be served when accessed via the API endpoint. (But if you anticipate very high volume access, please consider giving me a heads up, so I can ensure adequate server resources.)

The calculator will accept input through the URL query string and should be constructed in this format:

https://peditools.org/bili2022/api/?ga=[weeks]&age=[age(s)]&bili=[bili(s)]&risk=[none/any/both]...etc…

Required fields

• ga: completed weeks of gestation at birth
  • must be an integer 35 or higher
• age: age(s) at time of bilirubin measurement, in hours (or can submit a tcbage)
  • numeric between 1 and 336, will be rounded to nearest integer
  • can optionally be a comma-separated list, for multiple measurements

Optional fields

• bili: bilirubin measurement(s) in mg/dL
  • can optionally be a comma-separated list, for multiple measurements
  • can be left blank to just check thresholds
• risk: presence or absence of neurotoxicity risk factors
  • either "none", "any", or "both"
  • defaults to "both"
• plotchoice: original publication versus custom PediTools plots
  • either "original" or "peditools"
  • defaults to "peditools"
• plotscale: whether to use zoomed-in or full-scale (0 - 336 hour) plots
  • either "auto" (will used zoomed-in plot if all points will fit) or "full" (always use 0 - 336 hour plot)
  • defaults to "auto"
• tcbage: age(s) at time of transcutaneous bilirubin measurement, in hours
  • numeric between 1 and 336, will be rounded to nearest integer
  • can optionally be a comma-separated list, for multiple measurements
  • plotted in different color and are NOT used for rate-of-increase calculations
• tcb: transcutaneous bilirubin measurement(s) in mg/dL
  • can optionally be a comma-separated list, for multiple measurements
  • can be left blank to just check thresholds
  • plotted in different color and are NOT used for rate-of-increase calculations

Examples of properly formed queries:

• https://peditools.org/bili2022/api/?ga=40&age=48&bili=10
  • shows results for bilirubin of 10 mg/dL at 48 hours of age in a baby born at 40 weeks
  • defaults to showing for both with and without risk factors
    
    
• https://peditools.org/bili2022/api/?ga=40&age=48&bili=10&risk=any
  • shows results for bilirubin of 10 mg/dL at 48 hours of age in a baby born at 40 weeks with any neurotoxicity risk factors
    
    
• https://peditools.org/bili2022/api/?ga=35&age=24,48,72&bili=5,10,15&risk=none
  • shows results for a TREND of measurements at 24, 48, and 72 hours of bilirubins 5, 10, and 15 mg/dL, in a baby born at 35 weeks with no neurotoxicity risk factors
    
    
• https://peditools.org/bili2022/api/?ga=40&age=48
  • show treatment thresholds only (because no bilirubin measurement specified) at 48 hours for baby born at 40 weeks
  • defaults to showing both with and without risk factors
    
    
• https://peditools.org/bili2022/api/?ga=40&age=48&risk=none
  • show treatment thresholds at 48 hours for baby born at 40 weeks, without neurotoxicity risk factors