API Documentation > Retrieve Episode

Retrieves details for an episode that has previously been created. Provide an Episode ID and Knit will return the corresponding episode information.


The numeric identifier of the episode to be retrieved.


Returns a JSON object containing episode data if a valid episode id was provided, and returns and error otherwise.


Status polling

We’d prefer it if you used webhooks for this purpose. But, If you must use this method to determine if an episode is ready to be distributed, please be respectful of the service and limit calls to one per 30 second period. More than this and your API Key may be disabled. You’ll be looking for status to be “active” and the publish_status to be “live”. If either of those values are anything else it should not be distributed yet.


Example Request:

Example Response