> ## Documentation Index > Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get Filler Word Removal > Returns the job resource: lifecycle status, progress, and — once completed — the presigned download URL of the cleaned video plus removal statistics (num_cuts, reduction_pct, durations). ## OpenAPI ````yaml /openapi/external-api.json get /v3/filler-word-removals/{filler_word_removal_id} openapi: 3.1.0 info: title: HeyGen External API version: 1.0.0 description: >- HeyGen's external API for programmatic AI video creation. See https://docs.heygen.com for full documentation. contact: name: HeyGen Product Infra url: https://heygen.com servers: - url: https://api.heygen.com description: Production security: - ApiKeyAuth: [] - BearerAuth: [] tags: - name: Video Agent description: Create videos from text prompts using AI - name: Videos description: Create, list, retrieve, and delete videos - name: Templates description: Generate videos from reusable templates by replacing their variables - name: Voices description: Text-to-speech and voice management - name: Audio description: Search the background-music and sound-effects catalog - name: Video Translate description: Translate videos into other languages - name: AI Clipping description: Turn long-form videos into ready-to-share short clips with captions - name: Batches description: Create and track batches of videos. - name: Video Translation Batches description: Create and track batches of video translations. - name: Lipsync Batches description: Create and track batches of lipsyncs. - name: Asset Batches description: Create and track batches of direct-to-S3 asset uploads. - name: User description: Account information and billing - name: Avatars description: List and manage avatars and looks - name: Avatar Realtime description: >- Low-latency streaming avatar sessions — create a stream, poll for its HLS URL, push text, consume per-word timestamps - name: Assets description: Upload files for use in video creation - name: Webhooks description: Manage webhook endpoints and events - name: Lipsync description: Dub or replace audio on existing videos - name: Brand description: >- Brand-related resources — brand kits (colors, fonts, logos) and brand glossaries (custom term translations) - name: HyperFrames description: Render HyperFrames composition zips into video — separate from /v3/videos - name: Filler Word Removal description: '' paths: /v3/filler-word-removals/{filler_word_removal_id}: get: tags: - Filler Word Removal summary: Get Filler Word Removal description: >- Returns the job resource: lifecycle status, progress, and — once completed — the presigned download URL of the cleaned video plus removal statistics (num_cuts, reduction_pct, durations). operationId: getFillerWordRemovalV3 parameters: - name: filler_word_removal_id in: path required: true schema: type: string description: Unique filler word removal job identifier responses: '200': description: Successful response content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/FillerWordRemovalDetail' '400': description: Invalid request parameters content: application/json: schema: type: object properties: error: $ref: '#/components/schemas/StandardAPIError' '401': description: Authentication failed content: application/json: schema: type: object properties: error: $ref: '#/components/schemas/StandardAPIError' example: error: code: authentication_failed message: Invalid or expired API key. Verify your x-api-key header. param: null doc_url: null '404': description: Resource not found content: application/json: schema: type: object properties: error: $ref: '#/components/schemas/StandardAPIError' example: error: code: not_found message: Filler word removal job not found. param: null doc_url: null '429': description: Rate limit exceeded content: application/json: schema: type: object properties: error: $ref: '#/components/schemas/StandardAPIError' example: error: code: rate_limit_exceeded message: >- Too many requests. Retry after the duration specified in the Retry-After header. param: null doc_url: null headers: Retry-After: description: Seconds to wait before retrying schema: type: integer security: - ApiKeyAuth: [] - BearerAuth: [] components: schemas: FillerWordRemovalDetail: description: >- Full job resource returned by GET /v3/filler-word-removals/{id}. Invariant: ``status=completed`` always carries a ``video_url`` — when the run changes nothing (no filler cuts and no silence trims) the output is a byte-copy of the original and the charge is auto-refunded, so polling scripts never need a special no-op branch. Note ``num_cuts`` counts filler segments only; a run may report ``num_cuts=0`` yet still be billed when it trimmed long silences (``reduction_pct > 0``). properties: id: description: Unique job identifier. title: Id type: string title: anyOf: - type: string - type: 'null' default: null description: Display title. title: Title status: $ref: '#/components/schemas/FillerWordRemovalDetailJobStatus' description: Job lifecycle status. progress: default: 0 description: Approximate progress (0-100). 100 when completed. maximum: 100 minimum: 0 title: Progress type: integer video_url: anyOf: - type: string - type: 'null' default: null description: >- Presigned MP4 download URL of the cleaned video. Present when status=completed. Expires — re-fetch this endpoint for a fresh link. title: Video Url thumbnail_url: anyOf: - type: string - type: 'null' default: null description: >- Presigned thumbnail URL. Only present when status=completed and a thumbnail was generated. title: Thumbnail Url original_duration: anyOf: - type: number - type: 'null' default: null description: >- Duration of the source video in seconds. Present when status=completed. title: Original Duration output_duration: anyOf: - type: number - type: 'null' default: null description: >- Duration of the cleaned video in seconds. Present when status=completed. title: Output Duration num_cuts: anyOf: - type: integer - type: 'null' default: null description: >- Number of filler segments removed (silence-only trims are not counted — compare reduction_pct). The charge auto-refunds only when the run changed nothing at all. Present when status=completed. title: Num Cuts reduction_pct: anyOf: - type: number - type: 'null' default: null description: >- Percentage of the source duration removed. Present when status=completed. title: Reduction Pct callback_id: anyOf: - type: string - type: 'null' default: null description: Client-provided callback ID echoed from the create request. title: Callback Id created_at: anyOf: - type: integer - type: 'null' default: null description: Unix timestamp (seconds) of job creation. title: Created At failure_message: anyOf: - type: string - type: 'null' default: null description: Error description. Only present when status=failed. title: Failure Message required: - id - status title: FillerWordRemovalDetail type: object StandardAPIError: type: object properties: code: type: string description: Machine-readable error code example: invalid_parameter message: type: string description: Human-readable error message example: Video not found param: type: - string - 'null' description: Which request field caused the error doc_url: type: - string - 'null' description: Link to error documentation required: - code - message FillerWordRemovalDetailJobStatus: description: |- Public job lifecycle. Mirrors the v3 video-translation status set. No ``cancelled`` in v1 — there is no stop/delete endpoint yet; adding an enum value later is a non-breaking change. enum: - pending - running - completed - failed title: JobStatus type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: HeyGen API key. Obtain from your HeyGen dashboard. BearerAuth: type: http scheme: bearer description: OAuth2 bearer token. ````