One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.
Where the current provider attempt is: waiting means the provider accepted the audio and Helve is polling or awaiting its callback; unknown means Helve is reconciling an uncertain submission rather than re-sending it.
Why the job failed, present only when status is failed.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Helve","description":"One key, one request shape, one bill for web search, page extraction, and transcription across every provider.","colors":{"primary":"#14655a","light":"#37a08f","dark":"#14655a"},"logo":{"light":"https://mintcdn.com/helve/bd3M8ys9egZ2jyd-/logo/light.svg?fit=max\u0026auto=format\u0026n=bd3M8ys9egZ2jyd-\u0026q=85\u0026s=eb97b007a2ec2b7125f02ee2cc65b8d8","dark":"https://mintcdn.com/helve/bd3M8ys9egZ2jyd-/logo/dark.svg?fit=max\u0026auto=format\u0026n=bd3M8ys9egZ2jyd-\u0026q=85\u0026s=8b290a25b599307eeebdfb7fb4a04786","href":"https://helve.dev"},"favicon":"https://mintcdn.com/helve/bd3M8ys9egZ2jyd-/favicon.svg?fit=max\u0026auto=format\u0026n=bd3M8ys9egZ2jyd-\u0026q=85\u0026s=51062c58010b78bf395309f9beb81339","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://helve.dev","label":"Dashboard"}],"primary":{"type":"button","label":"Get an API key","href":"https://helve.dev"}},"footer":{"socials":{"github":"https://github.com/youssefarizk/tool-marketplace"},"links":[{"header":"Helve","items":[{"label":"Dashboard","href":"https://helve.dev"},{"label":"Terms","href":"https://helve.dev/terms"},{"label":"Privacy","href":"https://helve.dev/privacy"}]}]},"fonts":{"heading":{"family":"Archivo","weight":700}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"helve","hasAudioNarration":false,"actualSubdomain":"helve","customDomains":["docs.helve.dev"],"gitSource":{"type":"github","owner":"youssefarizk","repo":"tool-marketplace","deployBranch":"staging","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aabaa10096eb2d1ccbcd211","collectionId":"4119f034-be56-40c8-b787-c98a041ecd8f","liveDeploymentHistoryId":"6aabaa10096eb2d1ccbcd211","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aabaa10096eb2d1ccbcd211","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"API reference","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Tools","count":3},{"language":"default","tag":"Transcription","count":2},{"language":"default","tag":"Extract","count":1},{"language":"default","tag":"Search","count":1},{"language":"default","tag":"Integrations","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/get-job","slug":"/api-reference/get-job","pageMetadata":{"title":"Get a job","openapi":"openapi.json GET /v1/jobs/{id}","description":"One read for the whole lifecycle: state while the job runs, the transcript in `result` once it completes, the reason in `error` once it fails. Jobs are retained for seven days.","href":"/api-reference/get-job"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"One read for the whole lifecycle: state while the job runs, the transcript in \", _jsx(_components.code, {\n children: \"result\"\n }), \" once it completes, the reason in \", _jsx(_components.code, {\n children: \"error\"\n }), \" once it fails. Jobs are retained for seven days.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a job","openapi":"openapi.json GET /v1/jobs/{id}","description":"One read for the whole lifecycle: state while the job runs, the transcript in `result` once it completes, the reason in `error` once it fails. Jobs are retained for seven days.","href":"/api-reference/get-job"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getJob","tags":["Transcription"],"summary":"Get a job","description":"One read for the whole lifecycle: state while the job runs, the transcript in `result` once it completes, the reason in `error` once it fails. Jobs are retained for seven days.","security":["9c2e7249-d6f1-4ffd-b1d0-9041766b2b5b"],"parameters":["df4c0b13-c614-45b4-a11c-f75a1431b4b9"],"responses":{"200":"770564e8-28bb-4aac-9b6f-56675ba56adc","400":"2b90a5f3-ceae-4784-b307-27d54b15f685","401":"39c417e8-f195-45b5-9db6-9952416e4eab","402":"536ec2d9-79cb-485c-99d2-e60d97383f99","404":"df8b3c1c-1c3e-4b65-b604-47c173a8bec9","503":"71ae2091-2f69-4d49-85f9-41c57df094af"},"method":"get","type":"path","servers":["336702ba-c08f-4f5b-b5c5-aca0fb2290c6"],"path":"/v1/jobs/{id}","baseUrlOptions":["https://helve.dev"],"title":"Get a job","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"df4c0b13-c614-45b4-a11c-f75a1431b4b9":{"schema":{"type":"string","pattern":"^job_[0-9a-f-]{36}$","description":"The job id returned when the recording was submitted.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The job id returned when the recording was submitted.","name":"id","in":"path"}},"responses":{"770564e8-28bb-4aac-9b6f-56675ba56adc":{"description":"Job state, with the transcript once completed or the error once failed","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^job_[0-9a-f-]{36}$","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"tool":{"type":"string","enum":["transcription"],"isRequired":true,"uniqueKey":"tool","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["queued","running","completed","failed"],"description":"`queued` and `running` are in progress; `completed` carries `result`; `failed` carries `error`.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"provider":{"type":"string","enum":["assemblyai","deepgram","elevenlabs"],"isRequired":true,"uniqueKey":"provider","typeLabel":"enum\u003cstring>"},"model":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"model","typeLabel":"string | null"},"attempt_status":{"type":"string","enum":["queued","submitting","waiting","unknown","completed","failed"],"description":"Where the current provider attempt is: `waiting` means the provider accepted the audio and Helve is polling or awaiting its callback; `unknown` means Helve is reconciling an uncertain submission rather than re-sending it.","isRequired":true,"uniqueKey":"attempt_status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"finished_at":{"oneOf":[{"type":"string","format":"date-time","description":"Set once the job is `completed` or `failed`.","isRequired":true,"uniqueKey":"finished_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Set once the job is `completed` or `failed`.","isRequired":true,"uniqueKey":"finished_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"finished_at","typeLabel":"string\u003cdate-time> | null"},"result":{"oneOf":[{"type":"object","properties":{"text":{"type":"string","description":"The complete transcript with punctuation, as the provider produced it. Empty is valid for silence.","isRequired":true,"uniqueKey":"result.oneOf.0.text","typeLabel":"string"},"provider":{"type":"string","enum":["assemblyai","deepgram","elevenlabs"],"isRequired":true,"uniqueKey":"result.oneOf.0.provider","typeLabel":"enum\u003cstring>"},"model":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.model.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.0.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.0.model","typeLabel":"string | null"},"language":{"type":"string","pattern":"^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8})*$","description":"Detected or requested language tag.","uniqueKey":"result.oneOf.0.language","typeLabel":"string"},"duration_seconds":{"type":"number","minimum":0,"description":"Recording length when the provider reports it. Transcription is billed on this.","uniqueKey":"result.oneOf.0.duration_seconds","typeLabel":"number"},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.words.items.[INDEX].text","typeLabel":"string"},"start":{"type":"number","minimum":0,"description":"Seconds from the start of the recording.","isRequired":true,"uniqueKey":"result.oneOf.0.words.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","minimum":0,"description":"Seconds from the start of the recording.","isRequired":true,"uniqueKey":"result.oneOf.0.words.items.[INDEX].end","typeLabel":"number"},"speaker_id":{"type":"string","pattern":"^speaker_(0|[1-9]\\d*)$","description":"Present when `diarize` was set. Speaker ids are local to this transcript.","uniqueKey":"result.oneOf.0.words.items.[INDEX].speaker_id","typeLabel":"string"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Provider-reported 0–1 confidence. Not comparable across providers.","uniqueKey":"result.oneOf.0.words.items.[INDEX].confidence","typeLabel":"number"}},"required":["text","start","end"],"additionalProperties":false,"uniqueKey":"result.oneOf.0.words.items.[INDEX]","typeLabel":"object"},"description":"Per-word timings, omitted when `timestamps` is `none`.","uniqueKey":"result.oneOf.0.words","typeLabel":"object[]"},"usage":{"type":"object","properties":{"cost_usd":{"type":"number","minimum":0,"description":"What this transcription debited from your balance.","isRequired":true,"uniqueKey":"result.oneOf.0.usage.cost_usd","typeLabel":"number"},"credits":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.usage.credits","typeLabel":"integer"}},"required":["cost_usd","credits"],"additionalProperties":false,"description":"Present once the provider reported a duration: the charge for this transcription.","uniqueKey":"result.oneOf.0.usage","typeLabel":"object"}},"required":["text","provider","model"],"additionalProperties":false,"description":"The transcript, present only when `status` is `completed`.","isRequired":true,"uniqueKey":"result.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"text":{"type":"string","description":"The complete transcript with punctuation, as the provider produced it. Empty is valid for silence."},"language":{"type":"string","pattern":"^[a-zA-Z]{2,3}(?:-[a-zA-Z0-9]{2,8})*$","description":"Detected or requested language tag."},"duration_seconds":{"type":"number","minimum":0,"description":"Recording length when the provider reports it. Transcription is billed on this."},"words":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"start":{"type":"number","minimum":0,"description":"Seconds from the start of the recording."},"end":{"type":"number","minimum":0,"description":"Seconds from the start of the recording."},"speaker_id":{"type":"string","pattern":"^speaker_(0|[1-9]\\d*)$","description":"Present when `diarize` was set. Speaker ids are local to this transcript."},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Provider-reported 0–1 confidence. Not comparable across providers."}},"required":["text","start","end"],"additionalProperties":false},"description":"Per-word timings, omitted when `timestamps` is `none`."},"provider":{"type":"string","enum":["assemblyai","deepgram","elevenlabs"]},"model":{"oneOf":[{"type":"string"},{"type":"null"}]},"usage":{"type":"object","properties":{"cost_usd":{"type":"number","minimum":0,"description":"What this transcription debited from your balance."},"credits":{"type":"integer","minimum":0}},"required":["cost_usd","credits"],"additionalProperties":false,"description":"Present once the provider reported a duration: the charge for this transcription."}},"required":["text","provider","model"],"additionalProperties":false,"description":"The transcript, present only when `status` is `completed`.","isRequired":true,"uniqueKey":"result.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result","typeLabel":"object | null"},"error":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"}},"required":["type","message"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"error.oneOf.0.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.oneOf.0.additionalProperties","typeLabel":"null"},"description":"Why the job failed, present only when `status` is `failed`.","isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"type":{"type":"string"},"message":{"type":"string"}},"required":["type","message"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"error.oneOf.1.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.oneOf.1.additionalProperties","typeLabel":"null"},"description":"Why the job failed, present only when `status` is `failed`.","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"}},"required":["id","tool","status","provider","model","attempt_status","created_at","updated_at","finished_at","result","error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","tool":"transcription","status":"queued","provider":"assemblyai","model":"\u003cstring>","attempt_status":"queued","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","finished_at":"2023-11-07T05:31:56Z","result":{"text":"\u003cstring>","provider":"assemblyai","model":"\u003cstring>","language":"\u003cstring>","duration_seconds":1,"words":[{"text":"\u003cstring>","start":1,"end":1,"speaker_id":"\u003cstring>","confidence":0.5}],"usage":{"cost_usd":1,"credits":1}},"error":{"type":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2b90a5f3-ceae-4784-b307-27d54b15f685":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["unauthorized","invalid_request","provider_not_available","provider_not_configured","provider_error","not_found","insufficient_credits","internal_error"],"description":"Stable machine-readable category. `invalid_request` carries validation issues in `detail`; `provider_error` carries the provider's own error body.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","uniqueKey":"error.detail.oneOf.0","typeLabel":"any"},{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","type":"null","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"any | null"}},"required":["type","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"unauthorized","message":"\u003cstring>","detail":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"39c417e8-f195-45b5-9db6-9952416e4eab":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["unauthorized","invalid_request","provider_not_available","provider_not_configured","provider_error","not_found","insufficient_credits","internal_error"],"description":"Stable machine-readable category. `invalid_request` carries validation issues in `detail`; `provider_error` carries the provider's own error body.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","uniqueKey":"error.detail.oneOf.0","typeLabel":"any"},{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","type":"null","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"any | null"}},"required":["type","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"unauthorized","message":"\u003cstring>","detail":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"536ec2d9-79cb-485c-99d2-e60d97383f99":{"description":"Insufficient credits","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["unauthorized","invalid_request","provider_not_available","provider_not_configured","provider_error","not_found","insufficient_credits","internal_error"],"description":"Stable machine-readable category. `invalid_request` carries validation issues in `detail`; `provider_error` carries the provider's own error body.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","uniqueKey":"error.detail.oneOf.0","typeLabel":"any"},{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","type":"null","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"any | null"}},"required":["type","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"unauthorized","message":"\u003cstring>","detail":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"df8b3c1c-1c3e-4b65-b604-47c173a8bec9":{"description":"Job not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["unauthorized","invalid_request","provider_not_available","provider_not_configured","provider_error","not_found","insufficient_credits","internal_error"],"description":"Stable machine-readable category. `invalid_request` carries validation issues in `detail`; `provider_error` carries the provider's own error body.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","uniqueKey":"error.detail.oneOf.0","typeLabel":"any"},{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","type":"null","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"any | null"}},"required":["type","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"unauthorized","message":"\u003cstring>","detail":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"71ae2091-2f69-4d49-85f9-41c57df094af":{"description":"Durable execution or provider unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["unauthorized","invalid_request","provider_not_available","provider_not_configured","provider_error","not_found","insufficient_credits","internal_error"],"description":"Stable machine-readable category. `invalid_request` carries validation issues in `detail`; `provider_error` carries the provider's own error body.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","uniqueKey":"error.detail.oneOf.0","typeLabel":"any"},{"description":"Validation issues for `invalid_request`; the provider's error body for `provider_error`.","type":"null","uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.detail","typeLabel":"any | null"}},"required":["type","message"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"unauthorized","message":"\u003cstring>","detail":"\u003cunknown>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9c2e7249-d6f1-4ffd-b1d0-9041766b2b5b":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key from the dashboard, `sk_live_…`, sent as `Authorization: Bearer sk_live_…`.","scopes":[]}}},"servers":{"336702ba-c08f-4f5b-b5c5-aca0fb2290c6":{"url":"https://helve.dev","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key from the dashboard, `sk_live_…`, sent as `Authorization: Bearer sk_live_…`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key from the dashboard, `sk_live_…`, sent as `Authorization: Bearer sk_live_…`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"helve","siteName":"Helve","title":"Get a job - Helve","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T12:08:44.766Z","originalFileLocation":"api-reference/get-job.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Helve\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a job - Helve\">\u003cmeta data-mint-head property=\"og:description\" content=\"One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Helve\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.helve.dev/api-reference/get-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://helve.mintlify.app/_mintlify/api/og/v2?division=Transcription\u0026amp;title=Get+a+job\u0026amp;description=One+read+for+the+whole+lifecycle%3A+state+while+the+job+runs%2C+the+transcript+in+%60result%60+once+it+completes%2C+the+reason+in+%60error%60+once+it+fails.+Jobs+are+retained\u0026amp;theme=0f571ea141e669259272653e\u0026amp;signature=09cfb36eb1a7f91a91ce6b59c354712f803da97c5f3c606e0fb2ee8da14b225a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a job - Helve\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://helve.mintlify.app/_mintlify/api/og/v2?division=Transcription\u0026amp;title=Get+a+job\u0026amp;description=One+read+for+the+whole+lifecycle%3A+state+while+the+job+runs%2C+the+transcript+in+%60result%60+once+it+completes%2C+the+reason+in+%60error%60+once+it+fails.+Jobs+are+retained\u0026amp;theme=0f571ea141e669259272653e\u0026amp;signature=09cfb36eb1a7f91a91ce6b59c354712f803da97c5f3c606e0fb2ee8da14b225a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/helve/Mj0uqQ8YCWh4A1Yd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Helve\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#14655a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.helve.dev/api-reference/get-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.helve.dev/#organization\",\"name\":\"Helve\",\"url\":\"https://docs.helve.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/helve/bd3M8ys9egZ2jyd-/logo/light.svg?fit=max\u0026auto=format\u0026n=bd3M8ys9egZ2jyd-\u0026q=85\u0026s=eb97b007a2ec2b7125f02ee2cc65b8d8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.helve.dev#website\",\"name\":\"Helve\",\"url\":\"https://docs.helve.dev\",\"publisher\":{\"@id\":\"https://docs.helve.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.helve.dev/api-reference/get-job#webpage\",\"url\":\"https://docs.helve.dev/api-reference/get-job\",\"name\":\"Get a job\",\"description\":\"One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.\",\"dateModified\":\"2026-09-16T12:08:44.766Z\",\"isPartOf\":{\"@id\":\"https://docs.helve.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.helve.dev/api-reference/get-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.helve.dev/api-reference/get-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transcription\",\"item\":\"https://docs.helve.dev/api-reference/create-transcription\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a job\",\"item\":\"https://docs.helve.dev/api-reference/get-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.helve.dev/api-reference/get-job#apireference\",\"headline\":\"Get a job\",\"name\":\"Get a job\",\"description\":\"One read for the whole lifecycle: state while the job runs, the transcript in result once it completes, the reason in error once it fails. Jobs are retained for seven days.\",\"url\":\"https://docs.helve.dev/api-reference/get-job\",\"mainEntityOfPage\":{\"@id\":\"https://docs.helve.dev/api-reference/get-job#webpage\"},\"dateModified\":\"2026-09-16T12:08:44.766Z\",\"publisher\":{\"@id\":\"https://docs.helve.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.helve.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Helve\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Helve","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Search","pages":[{"title":"Search the web","openapi":"openapi.json POST /v1/search","href":"/api-reference/search"}]},{"group":"Extract","pages":[{"title":"Extract page content","openapi":"openapi.json POST /v1/extract","href":"/api-reference/extract"}]},{"group":"Transcription","pages":[{"title":"Transcribe a recording","openapi":"openapi.json POST /v1/transcriptions","description":"Submits a prerecorded file by URL and returns a job immediately. Helve records the attempt before contacting the provider, retries rate limits, never re-sends an uncertain submission, and fails the job at its deadline rather than leaving it hanging. Poll `GET /v1/jobs/{id}` for the transcript.","href":"/api-reference/create-transcription"},{"title":"Get a job","openapi":"openapi.json GET /v1/jobs/{id}","href":"/api-reference/get-job"}]}]}]},"title":"Get a job - Helve","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}