---
title: "Get similarity vector for a recording"
method: GET
path: "/api/v1/similarityVectors/{isrcOrTrackId}"
tags: ["similarity-vector-controller"]
---

# Get similarity vector for a recording

`GET /api/v1/similarityVectors/{isrcOrTrackId}`

## Request

- Base URL: `https://api.songtradr.com`
- URL: `https://api.songtradr.com/api/v1/similarityVectors/{isrcOrTrackId}`
- Auth: HTTP bearer

Returns the similarity vector for a recording. The recording is identified by its ISRC or a proprietary track ID.

## Path parameters

- `isrcOrTrackId` string, required

## Query parameters

- `vectorVersion` 'v2_4'
- `taxonomyVersion` 'v2_4'

## Response `200`

Success

- SimilarityVectorDto: Similarity vector for a recording.
  - `similarityVector` number[]
  - `isrc` string
  - `title` string
  - `artists` string[]

## Other responses

- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/songtradr/apis/songtradr-api.md) - [All operations](https://skmtc.dev/songtradr/apis/songtradr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/songtradr/apis/songtradr-api/revisions/31c6f2d1e9a4?raw)
