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
    }

Last updated