Hello, World!

Thanks for your interest in the PharmGKB API.

It is a RESTful interface that serves JSON representations of all our data, including our annotations (e.g. dosing guidelines, pathways, clinical annotations) and reference objects (e.g. genes, chemicals, variants).

We would love to get feedback on what we have so far, as well as hear about what you'd like to do with our API.

You're welcome to take a look and try things out. The Swagger documentation would be a good place to start.

While the endpoints are pretty stable, the parameters and responses may change at any time while we are developing it. Please keep an eye on the ClinPGx Blog for an announcement of the final, stable API. The final release will also be noted in the documentation.

Data Usage & License

All data accessed through this API is subject to the PharmGKB's Data Usage Policy. PharmGKB data is subject to the Creative Commons Attribution-ShareAlike 4.0 International License.

If you are planning on using the API for more than trivial tasks, please let us know. This helps us anticipate the amount of traffic to expect. Even more importantly, it helps us justify the need to support this API to funding agencies.

Limitation: please limit requests to 2 per second. Too frequent requests will result in a 429 response.

Documentation