Deduplication Queue Service - API Contract

GET /api/v1/deduplication-queue/api/v1/deduplication-queue

Fetch unresolved queue for a coordinator

Public

Response Example

{
  "data": [
    {
      "id": "dq-3301",
      "activity_id": "act-2998",
      "peer_id": "peer-0091",
      "coordinator_id": "coord-12",
      "status": "unresolved",
      "flagged_at": "2026-03-24T09:00:00Z",
      "duplicate_check_id": "dc-7841",
      "resolution_notes": null
    },
    {
      "id": "dq-3302",
      "activity_id": "act-3010",
      "peer_id": "peer-0105",
      "coordinator_id": "coord-12",
      "status": "unresolved",
      "flagged_at": "2026-03-25T07:45:00Z",
      "duplicate_check_id": "dc-7842",
      "resolution_notes": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 7
  },
  "unresolved_count": 7
}

GET /api/v1/deduplication-queue/api/v1/deduplication-queue/:id

Get a specific queue item

Public

Response Example

{
  "id": "dq-3301",
  "activity_id": "act-2998",
  "peer_id": "peer-0091",
  "coordinator_id": "coord-12",
  "status": "unresolved",
  "flagged_at": "2026-03-24T09:00:00Z",
  "duplicate_check_id": "dc-7841",
  "resolution_notes": null,
  "unresolved_count_for_coordinator": 7
}

POST /api/v1/deduplication-queue/api/v1/deduplication-queue

Add an item to the deduplication queue

Public

Request Example

{
  "activity_id": "act-3055",
  "peer_id": "peer-0118",
  "coordinator_id": "coord-12",
  "duplicate_check_id": "dc-7845"
}

Response Example

{
  "id": "dq-3303",
  "activity_id": "act-3055",
  "peer_id": "peer-0118",
  "coordinator_id": "coord-12",
  "status": "unresolved",
  "flagged_at": "2026-03-26T15:30:00Z",
  "duplicate_check_id": "dc-7845",
  "resolution_notes": null
}

PUT /api/v1/deduplication-queue/api/v1/deduplication-queue/:id

Resolve or dismiss a queue item

Public

Request Example

{
  "action": "resolve",
  "resolution": "merge",
  "resolved_by": "coord-12",
  "resolution_notes": "Merged duplicate into existing record act-2847."
}

Response Example

{
  "id": "dq-3301",
  "activity_id": "act-2998",
  "peer_id": "peer-0091",
  "coordinator_id": "coord-12",
  "status": "resolved",
  "resolution": "merge",
  "resolved_by": "coord-12",
  "resolved_at": "2026-03-26T15:45:00Z",
  "resolution_notes": "Merged duplicate into existing record act-2847."
}

DELETE /api/v1/deduplication-queue/api/v1/deduplication-queue/:id

Remove a queue item

Public

Response Example

{
  "message": "Queue item dq-3301 removed."
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}