GET /v1/transcriptions

List your transcriptions — Shorty API

Returns the authenticated account’s transcriptions, newest first, cursor-paginated. Pass the previous response’s `next_cursor` as `?cursor=` for the next page; a cursor is only valid against the SAME query it was minted under.

Open in ClaudeOpen in ChatGPT
GET /v1/transcriptions

Returns the authenticated account’s transcriptions, newest first, cursor-paginated. Pass the previous response’s next_cursor as ?cursor= for the next page; a cursor is only valid against the SAME query it was minted under.

Authentication

Requires a Bearer credential — a shk_live_ API key or an OAuth 2.1 access token with the scope for this resource. See Authentication.

Parameters

NameInRequiredDescription
cursorqueryNo
limitqueryNo

Example request

curl -X GET https://aishorty.com/v1/v1/transcriptions?cursor=cursorValue&limit=20 \
  -H "Authorization: Bearer shk_live_your_key"

Response · 200

FieldTypeRequiredDescription
dataTranscription[]Yes
has_morebooleanYesWhether another page exists after this one.
next_cursorstring or nullYesOpaque cursor for the next page (pass as ?cursor=), or null on the last page. Only valid against the SAME query filter.

Errors

On failure this endpoint returns an RFC 9457 problem body. Possible statuses:

  • 400
  • 401
  • 403
  • 429
  • 500

Switch on the problem code, not the status. See the error reference for every code and how to fix it.