Development status

Development of the PDG API is continuing in order to add additional features. See below for what is currently available and what features are still under development and will become available in the future.

Release notes for different versions of the Python API can be found in the CHANGELOG file.

Bug reports and feedback

To provide feedback on the PDG API or to report any bugs:

Features supported by the current version

  • REST API with pdgLive JSON download links

  • Python API API package pdg

  • PDG database files - see API page on the PDG website for available files

  • All the above tools support access to the data published in the Summary Tables (excluding footnotes), with access both via individual PDG Identifiers and navigation via particles to particle properties, branching fractions, and the corresponding Summary Table values.

  • Starting with the 2025 update of the Review of Particle Physics, experimental access to the data from the Particle Listings is available.

Limitations and known bugs of the current API version

  • Fit information and correlation matrices are not yet accessible

  • Conservation law data is not yet accessible

  • Some header text/notes of Listing sections are not yet accessible

  • Some text representations of values in the Listings lack parentheses, for example the API might return “2.60361+-0.00052E-8” instead of “(2.60361+-0.00052)E-8”

  • Numerical values are missing for some limits (only text representation is available)

Features under development

  • Implement access to the parts of the Listings data currently not yet accessible (see above)

  • Improved processing of aliases such as \ell and generic decay products in branching fractions

  • Improved handling of “indented” decay modes

  • Searching of PDG Identifiers and associated data (other than by low-level SQL querying of the data in the SQLite file)

  • General improvements of and extensions to existing features