🚀 apiv2 is live!
Soundverse’s Enterprise API platform has moved to apiv2.soundverse.ai, with self-serve account setup, API keys, and billing now managed at platform.soundverse.ai. Check the current docs there for the latest endpoints and auth.
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.