Get Duplicates

GET /v1/duplicates

Retrieve duplicates for a given entity or the entire catalog.

• URL: GET /v1/duplicates

  Optional Query Parameters:

  • entityId — returns duplicates only for the entity with this ID.

  • limit — maximum number of records to return (default is 100).

  • offset — pagination offset.

• Headers

  • Authorization: Bearer <YOUR_API_KEY>

• Example Request

  curl -X GET "https://api.getomni.ai/v1/duplicates?entityId=283JAD03&limit=10" \
    -H "Authorization: Bearer <YOUR_API_KEY>"

• Example Response

  {
    "entityId": "283JAD03",
    "duplicates": [
      {
        "id": 38291,
        "similarity": 0.87,
        "duplicate": true
      },
      {
        "id": 44512,
        "similarity": 0.80,
        "duplicate": false
      }
    ],
    "totalDuplicates": 2
  }

  If no entityId is provided, the endpoint can respond with a paginated list of all duplicates discovered in the catalog:

  jsonCopy code{
    "duplicates": [
      {
        "entityId": "283JAD03",
        "duplicateId": "XYE-83",
        "similarity": 0.87
      },
      {
        "entityId": "283JAD03",
        "duplicateId": "283JAD98",
        "similarity": 0.80
      }
    ],
    "limit": 10,
    "offset": 0,
    "total": 100000
  }