Get Mastering Progress Percentage

This endpoint gets the current processing status and percentage of completion for a mastering job.

GET https://platform.cryo-mix.com/api/percentage

Request Headers

Header	Type	Required	Description
`X-Api-Key`	string	Yes	Your client API key.
`Session-Id`	string	Yes	The unique session identifier you used to upload the file.
`Source`	string	Yes	Must be set to `Mastering API`.

Response

Success Response (200 OK)

Response Fields

Field	Type	Description
`status`	string	The current processing status.
`percentage_complete`	number	The completion percentage (0-100).
`processedFolderName`	string	The folder name for the processed files (only available when completed).
`processedObjectNames`	object	The final file names available for download (only available when completed).

Status Values

Status	Description
`pending`	The job is waiting to be processed.
`processing`	The job is currently being processed.
`completed`	The job has been completed successfully.
`failed`	The job has failed during processing.
`cancelled`	The job has been canceled.

Processing Status

{
  "data": {
    "status": "processing",
    "percentage_complete": 45
  },
  "message": "Api success",
  "status": "success",
  "code": 200
}

Completed Status

{
  "data": {
    "status": "completed",
    "percentage_complete": 100,
    "processedFolderName": "b0914412-7e97-432f-a480-0b575800f28c",
    "processedObjectNames": {
        "0": "FinalMaster.wav",
        "1": "FinalMaster.mp3",
        "2": "MasteringReport.json",
        "3": "OriginalMix.mp3"
    }
  },
  "message": "Api success",
  "status": "success",
  "code": 200
}

Failed Status

{
  "data": {
    "status": "failed"
  },
  "message": "Api success",
  "status": "success",
  "code": 200
}

Canceled Status

{
  "data": {
    "status": "cancelled"
  },
  "message": "Api success",
  "status": "success",
  "code": 200
}

Error Responses

400 Bad Request

{
  "message": "missing required parameters",
  "status": "error",
  "code": 400
}

Possible Causes:

• A required header (X-Api-Key, Session-Id, or Source) is missing or invalid.

• The Session-Id was not found.

• The mastering status is not available.

401 Unauthorized

{
  "message": "unauthorized client",
  "status": "error",
  "code": 401
}

Possible Causes:

• The API key is incorrect.

• The Source header is incorrect.

• The request is coming from a domain that is not on your list of allowed domains.

Usage Examples

JavaScript (Fetch)

const response = await fetch('https://platform.cryo-mix.com/api/percentage', {
  method: 'GET',
  headers: {
    'X-Api-Key': 'your-api-key-here',
    'Session-Id': 'unique-session-id',
    'Source': 'Mastering API'
  }
});

const result = await response.json();
console.log(`Status: ${result.data.status}`);
console.log(`Progress: ${result.data.percentage_complete}%`);

cURL

curl -X GET "https://platform.cryo-mix.com/api/percentage" \
  -H "X-Api-Key: your-api-key-here" \
  -H "Session-Id: unique-session-id" \
  -H "Source: Mastering API" \
  -H "Origin: your-domain.com"

Note

• The Session-Id is the same identifier used when uploading the file.

Overview

Endpoints