---
title: "Get audio alignment job"
method: GET
path: "/api/spaces/{accountId}/{spaceId}/audio-alignments/{alignmentJobId}"
tags: ["Asset"]
---

# Get audio alignment job

`GET /api/spaces/{accountId}/{spaceId}/audio-alignments/{alignmentJobId}`

## Request

- Base URL: `https://makefx.app`
- URL: `https://makefx.app/api/spaces/{accountId}/{spaceId}/audio-alignments/{alignmentJobId}`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://makefx.app/api/oauth/authorize`, token URL `https://makefx.app/api/oauth/token`, scopes: `read`)
  - API key in cookie `auth_token`

Reads or waits on one durable alignment job without returning the timing document.

## Path parameters

- `accountId` string, required: accountId path parameter
- `spaceId` string, required: spaceId path parameter
- `alignmentJobId` string, required: alignmentJobId path parameter

## Query parameters

- `wait_seconds` integer, nullable

## Headers

- `API-Version` '2026-09-10'

## Response `200`

Success

- object
  - `alignment_job` object, required
    - `alignment_job_id` string, required
    - `asset_id` string, required
    - `request_id` string, required
    - `status` 'queued' | 'running' | 'completed' | 'failed', required
    - `terms` string, required
    - `billing` 'platform' | 'own_key', required
    - `estimated_credits` integer, required
    - `charged_credits` integer, nullable, required
    - `error` object, nullable, required
      - `code` string, required
      - `message` string, required
      - `retryable` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
  - `word_timings` object, nullable, required
    - `schema_version` 1, required
    - `provenance` 'generated_alignment' | 'forced_alignment', required
    - `size_bytes` integer, required
  - `next_poll_seconds` integer, nullable, required

## Other responses

- `400`: The request did not match the schema
- `401`: No valid credentials. WWW-Authenticate names the protected resource metadata to start from
- `403`: The credentials are valid but not enough: the token lacks the scope, or the action needs a browser session rather than an app token
- `404`: Not found
- `429`: Rate limited. RateLimit names the policy; Retry-After says when to try again
- `500`: Internal server error

---

[API](https://skmtc.dev/makefx/apis/makefx-app-api.md) · [All operations](https://skmtc.dev/makefx/apis/makefx-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/makefx/apis/makefx-app-api/revisions/a05584da31c6?raw)