The JDHQ API
JDHQ exposes a REST API over HTTPS at /api/v1/. It's the same API that the jd CLI uses. And it's available to anyone who wants to build their own integration.
At launch (May 2026) it's pretty small, but I'll build it over time. My intent is that anything interactive on the site will also be presented by the API. Internally they use the same code to modify state.
As a result, parts of the API will likely require a paid account.
Documentation
The full reference is at /api/v1/docs/.
That page is generated from the same OpenAPI spec the API serves at /api/v1/openapi.json. If you'd rather drive your client off the spec directly, point your tool of choice at that URL.
Authentication
All endpoints require a Clerk API key, sent as a Bearer token:
Authorization: Bearer <your-api-key>Generate a key at accounts.johnnydecimal.com/user/api-keys.
Treat your API key like a password. It grants the same access to JDHQ that you have when signed in.
Stability
The v1 API will remain stable. But it's early days so I can't promise anything. That is to say, v2 might come along at any time. Probably not though ā like I say, I use the same API you do. It's in my interests to build it to be as stable as possible.
Let me know what you need it to do.