Skip to main content

​
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

ParameterTypeRequiredDescription
job_idstring✅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
      }
    }
  }
}

​
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 the error field of the payload for diagnostic details.