Duplicate Queue Repository - API Contract

GET /api/v1/queue-records/api/v1/queue-records

Fetch unresolved queue records for a coordinator

Public

Response Example

{
  "data": [
    {
      "id": "qr-7701",
      "activity_id": "act-2998",
      "peer_id": "peer-0091",
      "coordinator_id": "coord-12",
      "activity_type_id": "act-type-03",
      "date": "2026-03-24",
      "status": "unresolved",
      "flagged_at": "2026-03-24T09:00:00Z",
      "resolved_by": null,
      "resolved_at": null,
      "resolution_notes": null
    },
    {
      "id": "qr-7702",
      "activity_id": "act-3010",
      "peer_id": "peer-0105",
      "coordinator_id": "coord-12",
      "activity_type_id": "act-type-07",
      "date": "2026-03-25",
      "status": "unresolved",
      "flagged_at": "2026-03-25T07:45:00Z",
      "resolved_by": null,
      "resolved_at": null,
      "resolution_notes": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 7
  },
  "unresolved_count": 7
}

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

Get a specific queue record with siblings

Public

Response Example

{
  "id": "qr-7701",
  "activity_id": "act-2998",
  "peer_id": "peer-0091",
  "coordinator_id": "coord-12",
  "activity_type_id": "act-type-03",
  "date": "2026-03-24",
  "status": "unresolved",
  "flagged_at": "2026-03-24T09:00:00Z",
  "resolved_by": null,
  "resolved_at": null,
  "resolution_notes": null,
  "sibling_records": [
    {
      "id": "act-2847",
      "peer_id": "peer-0091",
      "activity_type_id": "act-type-03",
      "date": "2026-03-24",
      "submitted_at": "2026-03-24T08:00:00Z"
    }
  ]
}

POST /api/v1/queue-records/api/v1/queue-records

Create a new queue record

Public

Request Example

{
  "activity_id": "act-3070",
  "peer_id": "peer-0130",
  "coordinator_id": "coord-12",
  "activity_type_id": "act-type-03",
  "date": "2026-03-26"
}

Response Example

{
  "id": "qr-7703",
  "activity_id": "act-3070",
  "peer_id": "peer-0130",
  "coordinator_id": "coord-12",
  "activity_type_id": "act-type-03",
  "date": "2026-03-26",
  "status": "unresolved",
  "flagged_at": "2026-03-26T09:00:00Z",
  "resolved_by": null,
  "resolved_at": null,
  "resolution_notes": null
}

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

Mark a queue record as resolved

Public

Request Example

{
  "resolved_by": "coord-12",
  "resolution": "proceed",
  "resolution_notes": "Activity verified as unique — no duplicate found after manual review."
}

Response Example

{
  "id": "qr-7701",
  "activity_id": "act-2998",
  "peer_id": "peer-0091",
  "coordinator_id": "coord-12",
  "activity_type_id": "act-type-03",
  "date": "2026-03-24",
  "status": "resolved",
  "resolution": "proceed",
  "flagged_at": "2026-03-24T09:00:00Z",
  "resolved_by": "coord-12",
  "resolved_at": "2026-03-26T09:30:00Z",
  "resolution_notes": "Activity verified as unique — no duplicate found after manual review."
}

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

Delete a queue record

Public

Response Example

{
  "message": "Queue record qr-7701 deleted."
}

Additional Metadata

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