# API Reference

> Every Shorty API endpoint as an interactive reference page, generated from the OpenAPI 3.1 spec.

Interactive reference for every endpoint of the Shorty developer API, generated from the [OpenAPI 3.1 spec](/api/openapi). Each page renders the method, path, parameters, request and response schemas, and a request builder you can call with your own API key.

New here? Start with the [Developer API guide](/docs/api) for authentication, the quickstart, and the conventions every endpoint follows.

| Endpoint | What it does |
| --- | --- |
| [`GET /v1/usage`](/docs/api-reference/getUsage) | Get plan, limits, and usage |
| [`GET /v1/articles`](/docs/api-reference/listArticles) | List your articles |
| [`GET /v1/articles/search`](/docs/api-reference/searchArticles) | Search your articles |
| [`GET /v1/articles/{articleId}`](/docs/api-reference/getArticle) | Get an article |
| [`GET /v1/transcriptions`](/docs/api-reference/listTranscriptions) | List your transcriptions |
| [`POST /v1/transcriptions`](/docs/api-reference/createTranscription) | Create a transcription |
| [`GET /v1/transcriptions/{transcriptionId}`](/docs/api-reference/getTranscription) | Get a transcription |
| [`GET /v1/jobs/{jobId}`](/docs/api-reference/getJob) | Get job status |
| [`GET /v1/subtitles/{jobId}/download`](/docs/api-reference/downloadSubtitles) | Download a subtitle artifact |
| [`POST /v1/summaries`](/docs/api-reference/createSummary) | Create a summary |
| [`POST /v1/subtitles`](/docs/api-reference/createSubtitles) | Create subtitles |