> ## Documentation Index > Fetch the complete documentation index at: https://docs.motion.so/llms.txt > Use this file to discover all available pages before exploring further. # Get video job status ## OpenAPI ````yaml /openapi.json get /sessions/{job_id} openapi: 3.1.0 info: title: Motion version: 1.0.0 description: >- Create and edit videos with Motion through a prompt, optional attachments, and follow-up edits. New video jobs default to GVA standard. Motion Legacy requires eligible existing-account or administrator access. Use GET /engines for available choices. Manage owner-scoped automations, schedules, run history, and analytics. Automation execution is GVA-only and defaults to standard effort. servers: - url: https://api.motion.so/api/motion security: - MotionApiKey: [] paths: /sessions/{job_id}: get: summary: Get video job status operationId: getMotionSessionStatus parameters: - name: job_id in: path required: true schema: type: string description: Job ID returned by POST /sessions. responses: '200': description: Job status content: application/json: schema: $ref: '#/components/schemas/MotionJobStatus' '401': description: Missing or invalid Motion API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Job not found or not owned by API key user content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - MotionApiKey: [] components: schemas: MotionJobStatus: type: object required: - job_id - status - created_at - updated_at - completed_at - error - pending_user_input - output properties: job_id: type: string status: type: string enum: - queued - created - running - awaiting_user_input - completed - failed chat_url: type: - string - 'null' format: uri description: >- Motion app chat URL for a human to open, inspect, or continue the run. Null for legacy jobs without a Motion agent chat. created_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: - string - 'null' format: date-time error: type: - string - 'null' pending_user_input: type: boolean output: anyOf: - $ref: '#/components/schemas/MotionJobOutput' - type: 'null' description: >- Download readiness state. There is no separate public output/download endpoint; poll this status response until output.status is completed and output.download_url is non-null. sources: type: array description: >- Additive source-asset audit list for media currently used in the composition. Empty when no source assets are recorded yet. Internal storage paths, filenames, and GCS URIs are not exposed. items: $ref: '#/components/schemas/MotionCompositionSource' engine: type: - string - 'null' description: Null when engine details are unavailable to this account. effort: type: - string - 'null' enum: - standard - extended - light - medium - high - null description: Null when engine details are unavailable to this account. template: type: - string - 'null' ErrorResponse: type: object required: - error properties: error: type: string details: type: array items: type: object MotionJobOutput: type: object required: - status - download_url - expires_at - completed_at - error properties: status: type: string enum: - pending - queued - processing - completed - failed - outdated download_url: type: - string - 'null' format: uri description: Signed MP4 download URL. Present only when status is completed. expires_at: type: - string - 'null' format: date-time description: Expiration timestamp for download_url. completed_at: type: - string - 'null' format: date-time error: type: - string - 'null' MotionCompositionSource: type: object additionalProperties: false required: - id - source_kind - provider - provider_asset_id - source_url - display_url - source_domain - media_type - title - credit - rights_status - usages - source_metadata - rights_metadata properties: id: type: string source_kind: type: string enum: - licensed_library - article - web_search - web - connector - upload - generated - unknown description: How the asset was acquired. provider: type: string description: >- Provider or origin, such as getty, pexels, perplexity, github, or an article domain. provider_asset_id: type: - string - 'null' description: Provider-specific asset ID when available. source_url: type: - string - 'null' format: uri description: Canonical public source URL when available. display_url: type: - string - 'null' format: uri description: Preview/display URL when available. source_domain: type: - string - 'null' media_type: type: string enum: - image - video - audio - file - unknown title: type: - string - 'null' credit: type: - string - 'null' rights_status: type: string enum: - licensed - public - restricted - user_provided - generated - unknown description: Best-known rights category for the source asset. usages: type: array items: $ref: '#/components/schemas/MotionCompositionSourceUsage' source_metadata: type: object description: >- Provider/source-specific public metadata. Shape varies by source kind and provider. additionalProperties: true rights_metadata: type: object description: >- Provider/license-specific rights metadata. Shape varies by source kind and provider. additionalProperties: true MotionCompositionSourceUsage: type: object additionalProperties: false properties: start_seconds: type: - number - 'null' description: Timeline start time in seconds when known. end_seconds: type: - number - 'null' description: Timeline end time in seconds when known. duration_seconds: type: - number - 'null' description: Timeline duration in seconds when known. scene_id: type: - string - 'null' scene_index: type: - number - 'null' slot_key: type: - string - 'null' element_tag: type: - string - 'null' description: Composition element tag such as img, video, audio, or source. composition_file: type: - string - 'null' composition_id: type: - string - 'null' track_index: type: - number - 'null' securitySchemes: MotionApiKey: type: http scheme: bearer description: >- Motion API key (motion_ prefix), authenticated as its owner. Account and engine permissions still apply. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.