---
title: "Get fields similar to this one"
method: GET
path: "/v1/fields/{id}/similar"
tags: ["Schemas"]
---

# Get fields similar to this one

`GET /v1/fields/{id}/similar`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/fields/{id}/similar`
- Auth: HTTP bearer

Returns up to 10 fields most similar to this one by cosine similarity
on the `name_embedding` vector (all-MiniLM-L6-v2, 384 dims). Returns
an empty `data` array if the field has no embedding computed yet.

## Path parameters

- `id` string, uuid, required

## Response `200`

Similar fields by embedding cosine similarity.

- object
  - `data` object[]
    - `id` string, uuid, required
    - `canonical_name` string, required
    - `similarity` number, float, required
    - `links` object, required
      - `self` string
  - `message` string: Present when the field has no embedding.

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)