Current Version: 0.9.1 (Changes)

API Root: https://api.pnut.io/v0

The most recent major version can also be accessed with root https://api.pnut.io.

Last Updated 2018-09-13

Welcome to the documentation for the Pnut API.

Become a Developer

If this is your first time here, it is recommended that you become familiar with the Implementation section and then read Authentication and determine what scopes and strategy you will want to use.

The How To section has some examples and explanation of some common situations.

Notes on Examples

cURL examples can be edited on-page (they have the HTML5 contenteditable property). To call the API from the docs and see the cURL responses live, you must log in and authorize the API Documentation app linked from each example.

The button in the top-right of the page collapses and expands all endpoints. A page linked directly to a targetted endpoint will only have that endpoint expanded. When the page loads, all endpoints are locked in their expanded or collapsed display. Toggling the button will allow you to open and close endpoints by clicking their title.

External Resources

Developer Chat

You are welcome to talk over the API in the Developer Channel. Questions, requests, floating ideas--any development-related conversation is encouraged!


List of libraries and code to easily interact with the API from various languages.

API Documentation

GitHub has a mirror of our API documentation. That is the recommended way to formally submit bugs and feature requests.

Object Metadata

A repository for object metadata to coordinate common channel and Raw types.


If you are developing an app for iOS, the @testuser account can be used for Apple Store reviewing.

Backup API Root

There is a backup API Root at https://api.pnut-api-1.org/v0. The same subdomains and endpoints are available with this domain. DNS issues are known to occur (especially internationally), and if one does not work, the other may.