Get Comprehensive Search Status
Check the status and fetch results for a Comprehensive Search similarity search job. This endpoint is completely free to poll and does not deduct balance.-
/trace/v1/comprehensive1/jobs/{job_id}
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | ✅ | Unique job ID returned from a Comprehensive Search POST request. |
Response Examples
{
"success": true,
"data": {
"job_id": "comprehensive_job_uuid",
"status": "completed",
"search_type": "1:n",
"error": null,
"results": {
"status": "success",
"timestamp": "2026-06-19 22:45:00",
"search_type": "1:n",
"results": [
{
"query_audio_id": "dataset/query_song_1.wav",
"matches": [
{
"id": "dataset/candidate_song_1.wav",
"score": 0.804,
"percentage": 80.4,
"payload": {
"filename": "candidate_song_1.wav",
"dataset_id": "dataset-uuid",
"metric": "max_then_mean"
},
"full_audio_latent_scores": {
"max": 0.837,
"max_then_mean": 0.804,
"hungarian_mean": 0.705,
"matched_windows": [
{
"query_index": 7,
"candidate_index": 4,
"similarity_score": 0.786,
"query_audio_timestamps": [[62.3], [70.3]],
"candidate_audio_timestamps": [[62.5], [70.5]]
}
]
},
"vocal_latent_scores": {
"max": 0.555,
"max_then_mean": 0.489,
"hungarian_mean": 0.340
},
"motif_matches": {
"vocals_stem": {
"total_matches": 9,
"matches": [
{
"similarity_score": 0.638,
"query": { "motif_audio_timestamps": [141.4, 152.5] },
"candidate": { "motif_audio_timestamps": [88.8, 97.4] }
}
]
}
}
}
]
}
],
"summary": {
"full_audio_max_then_mean": 0.505,
"vocal_max": 0.935,
"motif_matches_other_count": 313,
"motif_matches_vocals_count": 2706
}
}
}
}
{
"success": true,
"data": {
"job_id": "comprehensive_job_uuid",
"status": "completed",
"search_type": "m:n",
"error": null,
"results": {
"status": "success",
"timestamp": "2026-06-19 22:45:00",
"search_type": "m:n",
"results": [
{
"query_audio_id": "dataset/incoming_track_1.wav",
"matches": [
{
"id": "dataset/catalog_reference_99.wav",
"score": 0.804,
"percentage": 80.4,
"payload": {
"filename": "original_mix_99.wav",
"dataset_id": "ref-uuid",
"metric": "max_then_mean"
},
"full_audio_latent_scores": {
"max": 0.837,
"max_then_mean": 0.804,
"hungarian_mean": 0.705,
"matched_windows": [
{
"query_index": 7,
"candidate_index": 4,
"similarity_score": 0.786,
"query_audio_timestamps": [[62.3], [70.3]],
"candidate_audio_timestamps": [[62.5], [70.5]]
}
]
},
"vocal_latent_scores": {
"max": 0.555,
"max_then_mean": 0.489,
"hungarian_mean": 0.340
},
"motif_matches": {
"vocals_stem": {
"total_matches": 9,
"matches": [
{
"similarity_score": 0.638,
"query": { "motif_audio_timestamps": [141.4, 152.5] },
"candidate": { "motif_audio_timestamps": [88.8, 97.4] }
}
]
}
}
}
]
},
{
"query_audio_id": "dataset/incoming_track_2.wav",
"matches": [
{
"id": "dataset/catalog_reference_99.wav",
"score": 0.804,
"percentage": 80.4,
"payload": {
"filename": "original_mix_99.wav",
"dataset_id": "ref-uuid",
"metric": "max_then_mean"
},
"full_audio_latent_scores": {
"max": 0.837,
"max_then_mean": 0.804,
"hungarian_mean": 0.705,
"matched_windows": [
{
"query_index": 7,
"candidate_index": 4,
"similarity_score": 0.786,
"query_audio_timestamps": [[62.3], [70.3]],
"candidate_audio_timestamps": [[62.5], [70.5]]
}
]
},
"vocal_latent_scores": {
"max": 0.555,
"max_then_mean": 0.489,
"hungarian_mean": 0.340
},
"motif_matches": {
"vocals_stem": {
"total_matches": 9,
"matches": [
{
"similarity_score": 0.638,
"query": { "motif_audio_timestamps": [141.4, 152.5] },
"candidate": { "motif_audio_timestamps": [88.8, 97.4] }
}
]
}
}
}
]
}
],
"summary": {
"full_audio_max_then_mean": 0.505,
"vocal_max": 0.935,
"motif_matches_other_count": 313,
"motif_matches_vocals_count": 2706
}
}
}
}
Job States
pending: Job is queued and waiting for an available worker thread on the GPU pool.processing: Job is active, running stem extraction, audio encoding, and sequence alignments.completed: Job completed successfully. All metric breakdowns, ranked lists, and summaries are available.failed: An error occurred during processing or alignment. Look in theerrorfield of the payload for diagnostic details.