Developers · SDKs
Official SDKs.
Ready-made clients for JavaScript/TypeScript and Python. One file each, no dependencies: download it into your project and go.
Every endpoint
Stations, now playing, what aired, logs, the library, records, actions, audio, and the on-air controls.
Safe retries
Rate limits and temporary errors are retried for you, and every change carries an Idempotency-Key, so a retry never runs twice.
Paging and watching
paginate walks through every page; watch tells you when an answer changes.
Safe edits
getRecord gives you the record's ETag; pass it to updateRecord or deleteRecord and nothing is overwritten.
Audio in one call
addToLibrary uploads a file and creates the library item.
Webhooks
verifyWebhook checks a delivery's signature.
JavaScript & TypeScript
Node, Deno, Bun, Workers.
index.mjs is the client and index.d.ts its types. Use it in server-side code only: an API key in a web page can be copied by anyone.
In Deno you can import it straight from https://stationmonster.com/sdk/js/index.mjs.
Python
Python 3.8 and up.
One file using only the standard library. Put it next to your script.
Webhooks
Check every delivery.
Both SDKs check the X-StationMonster-Signature header against your webhook's secret (Python: verify_webhook). Pass the body exactly as it arrived.
Another language? Import the OpenAPI document into a code generator (openapi-generator, oapi-codegen, NSwag…) or Postman. The SDKs and the document follow the same list of endpoints, so they never drift apart.


