Get track versions job status

GET 
/v0/tracks/versions/:jobId

This endpoint allows you to check the status of a track versions job. When the job is complete, it will return the URLs to the generated tracks.

Waveform Data:

• By default, waveform data is excluded to reduce payload size
• Use expand=waveform to include waveform data in the response

Request

Path Parameters

jobId anyrequired

The ID of the job to check

Query Parameters

expand any

Include additional data in response. Use 'waveform' to include waveform data.

Responses

200

Track edit job response

application/json

Schema

Schema

status string

Possible values: [PENDING, PROCESSING, COMPLETED, FAILED]

results

object[]

Array [

previewUrl string

waveform

object

version int32

channels int32

sampleRate int32

samplesPerPixel int32

bits int32

length int32

data int32[]

highQualityUrl string

]

message string
jobId uuid

Example (from schema)

{
  "status": "PENDING",
  "results": [
    {
      "previewUrl": "string",
      "waveform": {
        "version": 0,
        "channels": 0,
        "sampleRate": 0,
        "samplesPerPixel": 0,
        "bits": 0,
        "length": 0,
        "data": [
          0
        ]
      },
      "highQualityUrl": "string"
    }
  ],
  "message": "string",
  "jobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Example

{
  "status": "COMPLETED",
  "results": [
    {
      "previewUrl": "https://cdn.epidemicsound.com/edited-tracks/12345.mp3",
      "highQualityUrl": "https://cdn.epidemicsound.com/edited-tracks/12345.wav"
    }
  ],
  "message": "Job completed successfully",
  "jobId": "c9ee7986-eddb-414c-9565-e815a3279e0d"
}

400

Bad request.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Bad request"
}

401

Unauthorized. Most likely your access token has expired.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Invalid credentials"
}

429

Rate limit exceeded.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Rate limit exceeded"
}

Loading...