> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.labric.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.labric.co/_mcp/server.

# List similar images

GET https://platform.labric.co/api/v1/images/{file_id}/similar

List the organization's images that look most like an image, most
similar first.

Each result has a similarity from -1 to 1, where higher means more alike.
Pass min_similarity to leave out weaker matches. Similarity values can
change when the platform updates how it compares images, so use them to
rank results and not as stored thresholds.

The file must be a processed image that has been analyzed for similarity.

Each result also has a signed thumbnail_url. Signed URLs expire, so download
thumbnails soon after listing them. Returns 409 when the image has not been
analyzed for similarity.

Requires an API key with the `read` scope.

Reference: https://docs.labric.co/api-reference/labric-api/images/list-similar

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `file_id` (string, required)

### Query parameters

- `limit` (integer, optional, default: 10)
- `min_similarity` (double, optional, nullable)

## Response

### 200

OK

- `images` (list of SimilarImageMatchSchema, required) — The most similar images, most similar first.

## Errors

### 400 Bad Request Error

Bad Request

- `detail` (string, required)

### 401 Unauthorized Error

Unauthorized

- `detail` (string, required)

### 403 Forbidden Error

Forbidden

- `detail` (string, required)

### 404 Not Found Error

Not Found

- `detail` (string, required)

### 409 Conflict Error

Conflict

- `detail` (string, required)

### 422 Unprocessable Entity Error

Unprocessable Content

- `detail` (list of map from string to any, required)

### 500 Internal Server Error

Internal Server Error

- `detail` (string, required)

## Types

### SimilarImageMatchSchema

- `file_id` (string, required)
- `original_path` (string, required, nullable) — Path of the file as it was uploaded.
- `similarity` (double, required) — Cosine similarity to the queried image, from -1 to 1. Higher means more alike.
- `thumbnail_url` (string, required, nullable) — Signed URL of a thumbnail. It expires after 15 minutes.
- `file_modified_at` (datetime, required, nullable)

## Examples

**Response**

```json
{
  "images": [
    {
      "file_id": "string",
      "original_path": "string",
      "similarity": 1.1,
      "thumbnail_url": "string",
      "file_modified_at": "2024-01-15T09:30:00Z"
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://platform.labric.co/api/v1/images/file_id/similar"

headers = {"Authorization": "Bearer <api_key>"}

response = requests.get(url, headers=headers)

print(response.json())
```