# API operations — Shorty API

> Every endpoint of the Shorty developer API, grouped by resource, with request and response schemas and curl + TypeScript examples.

Every Shorty API endpoint, grouped by resource. Each page shows the method, path, parameters, request and response schemas, error codes, and curl + SDK examples.

## Usage

- [GET /v1/usage](/docs/api-reference/getUsage) — Get plan, limits, and usage

## Articles

- [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

## Transcriptions

- [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

## Jobs

- [GET /v1/jobs/{jobId}](/docs/api-reference/getJob) — Get job status

## Subtitles

- [GET /v1/subtitles/{jobId}/download](/docs/api-reference/downloadSubtitles) — Download a subtitle artifact
- [POST /v1/subtitles](/docs/api-reference/createSubtitles) — Create subtitles

## Summaries

- [POST /v1/summaries](/docs/api-reference/createSummary) — Create a summary