# Maybloc API > Maybloc is a speech-to-text API for recordings with more than one voice. Every speaker separated, overlapping speech kept, every word timed. - [Maybloc API documentation](https://docs.maybloc.com/index.md): Transcribe recordings with the Maybloc REST API and get every speaker, every word's timing and every overlap back as JSON. Pricing, limits, webhooks and code examples. - [Transcribe a recording with the Maybloc API](https://docs.maybloc.com/quickstart.md): Create an upload, send the file, start a transcript and read the speakers and word times, in four API requests. Examples in curl, Node.js and Python. - [How to authenticate Maybloc API requests](https://docs.maybloc.com/authentication.md): Create an API key in the console and send it as a bearer token in the Authorization header. Read-only keys can list and read transcripts but not change them. - [What does a Maybloc transcript result contain?](https://docs.maybloc.com/guides/results.md): The result lists speakers, turns with word timestamps, overlaps where people talk at once, speaker activity and conversation analytics. Field-by-field reference with an example. - [Maybloc add-ons: redaction, summaries, sentiment and translation](https://docs.maybloc.com/guides/add-ons.md): Ten add-ons you switch on per request: PII redaction, smart formatting, subtitles, insights, speaker names, sentiment, topics, key terms, custom fields and translation. Prices per minute. - [Languages supported by the Maybloc API](https://docs.maybloc.com/guides/languages.md): The API transcribes 45 languages. Set config.language to a language code, or leave it as auto to detect the language. Full list with codes. - [Export a Maybloc transcript as SRT, WebVTT or text](https://docs.maybloc.com/guides/subtitles-and-exports.md): Download a transcript as an SRT or WebVTT subtitle file or as plain text, with speaker names. The subtitles add-on cuts caption-sized cues. - [Maybloc webhooks: events, signatures and retries](https://docs.maybloc.com/guides/webhooks.md): Get a signed POST when a transcript is queued, processing, completed, failed or canceled, or when add-ons are ready. How to verify the signature, and how failed deliveries are retried. - [Maybloc API errors, rate limits and idempotency](https://docs.maybloc.com/guides/errors-and-limits.md): Every error code the API returns, what it means and how to fix it, plus the per-key rate limit, idempotency keys, and recording size and length limits. - [Maybloc API pricing: per-minute rates and add-on prices](https://docs.maybloc.com/guides/pricing.md): calico-1-flash costs $0.006 per minute, billed by the second. Add-ons cost a fraction of a cent per minute. Failed and canceled transcripts are free. Worked example. - [Maybloc data retention, deletion and privacy](https://docs.maybloc.com/guides/data-retention.md): Recordings are kept 7 days and results 30 days, then deleted. You can delete a transcript and its recording at any time. Recordings are private to your workspace and not used to train models. - [Use the Maybloc docs with AI agents and coding assistants](https://docs.maybloc.com/guides/ai-agents.md): How coding agents and AI assistants can read the Maybloc documentation: llms.txt, Markdown pages, the OpenAPI specification and the docs MCP server. - [Retrieve the account](https://docs.maybloc.com/api-reference/retrieve-the-account.md): The workspace's balance, to check credit before submitting, and the calling key's scope. - [Create an upload](https://docs.maybloc.com/api-reference/create-an-upload.md): Returns a URL that accepts one PUT of the file for 15 minutes. - [Complete an upload](https://docs.maybloc.com/api-reference/complete-an-upload.md): Call after the PUT succeeds. The file's size and type are checked before it can be transcribed. - [List transcripts](https://docs.maybloc.com/api-reference/list-transcripts.md): Transcripts newest first, up to limit per page. To read the next page, pass the last id as starting_after while has_more is true. - [Create a transcript](https://docs.maybloc.com/api-reference/create-a-transcript.md): Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once. - [Retrieve a transcript](https://docs.maybloc.com/api-reference/retrieve-a-transcript.md): Returns the transcript's status, configuration, duration and cost. Poll it until status is completed, failed or canceled, then read the result. - [Rename a transcript or its speakers](https://docs.maybloc.com/api-reference/rename-a-transcript-or-its-speakers.md): Renames the transcript, or names its speakers with speaker_names, for example {"speaker_1": "Ana"}. The names appear on the transcript, in exports and in generated add-on text. - [Delete a transcript](https://docs.maybloc.com/api-reference/delete-a-transcript.md): Deletes the recording and its transcript now. Billing records stay. Cancel a running transcript first. - [Retrieve the result](https://docs.maybloc.com/api-reference/retrieve-the-result.md): Available once the transcript is completed. - [Export subtitles or text](https://docs.maybloc.com/api-reference/export-subtitles-or-text.md): The transcript as an SRT or WebVTT subtitle file, or plain text, with speaker names. Subtitles use caption-sized cues when the subtitles add-on is on, otherwise one cue per turn. With redact_pii the text is redacted. - [Add add-ons](https://docs.maybloc.com/api-reference/add-add-ons.md): Adds add-ons to a completed transcript without transcribing it again, or more translation languages and custom fields to the ones it has. The difference in per-minute price is charged for the recording's length. Generated add-ons are then produced, and the transcript.addons.completed webhook fires w… - [Cancel a transcript](https://docs.maybloc.com/api-reference/cancel-a-transcript.md): Stops a queued or running transcript. Canceled transcripts are not charged. ## OpenAPI Specs - [openapi](https://app.maybloc.com/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.