> ## Documentation Index
> Fetch the complete documentation index at: https://help.soundverse.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Comprehensive Search Status

> Poll the status and retrieve structured alignment results of a Comprehensive Search search.

import React from 'react';

export const Method = ({ type, children }) => {
  const styles = {
    GET: {
      backgroundColor: "#2563eb",
      color: "white",
      padding: "3px 6px",
      borderRadius: "6px",
      fontSize: "0.85rem",
      fontWeight: "bold",
      display: "inline-block",
      marginRight: "8px"
    }
  };
  return <span style={styles[type] || styles.GET}>{children || type}</span>;
};

## **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.

* <Method type="GET">GET</Method> `/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**

<CodeGroup>
  ```json Completed 1:N Response theme={null}
  {
    "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
        }
      }
    }
  }
  ```

  ```json Completed M:N Response theme={null}
  {
    "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
        }
      }
    }
  }
  ```
</CodeGroup>

***

### **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.