---
title: "POST /api/v1/similarity/document-similarity-by-features/"
method: POST
path: "/api/v1/similarity/document-similarity-by-features/"
tags: ["similarity", "v1"]
---

# POST /api/v1/similarity/document-similarity-by-features/

`POST /api/v1/similarity/document-similarity-by-features/`

"Similarity" admin task

POST params:
    - similarity_threshold: int
    - use_tfidf: bool
    - delete: bool
    - project: int
    - feature_source: list - list[date, definition, duration, court,
      currency_name, currency_value, term, party, geoentity]
    - distance_type: str - see scipy.spatial.distance._METRICS

## Request body

- DocumentSimilarityByFeaturesForm
  - `run_name` string, required
  - `similarity_threshold` integer, nullable
  - `project` integer, required
  - `feature_source` 'date' | 'definition' | 'duration' | 'court' | 'currency_name' | 'currency_value' | 'term' | 'party' | 'geoentity', nullable
  - `distance_type` 'braycurtis' | 'canberra' | 'chebyshev' | 'cityblock' | 'correlation' | 'cosine' | 'dice' | 'euclidean' | 'hamming' | 'jaccard' | 'jensenshannon' | 'kulsinski' | 'kulczynski1' | 'mahalanobis' | 'minkowski' | 'rogerstanimoto' | 'russellrao' | 'seuclidean' | 'sokalmichener' | 'sokalsneath' | 'sqeuclidean' | 'yule', nullable
  - `item_id` integer, required
  - `create_reverse_relations` boolean, required
  - `use_tfidf` boolean, required
  - `delete` boolean, required

## Response `200`

- SimilarityPOSTObjectResponse
  - `detail` string, required
  - `task_id` string
  - `confirm` boolean

---

[API](https://skmtc.net/lexpredict/apis/contraxsuite-api.md) · [All operations](https://skmtc.net/lexpredict/apis/contraxsuite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lexpredict/contraxsuite-api/revisions/3429f921b4cb/schema)