Report Duplicate

Submitting a report works with a regular API key. Resolving a report (POST /api/v1/reference/duplicates/{reportId}/resolve) is backoffice-only and requires an admin key.

POST /api/v1/reference/duplicates

Submit a new duplicate report.

POST https://api.mapping.travel/api/v1/reference/duplicates

Request body

string

required

UUID of the reference hotel you consider canonical (the one to keep).

string

required

UUID of the reference hotel you believe is a duplicate of originalHotelId.

string

Optional identifier for the source that surfaced the duplicate (e.g. a supplier or dataset reference).

string

Optional free-text explanation of why the two hotels are duplicates.

The complete accepted body is { originalHotelId, duplicateHotelId, duplicateSourceId?, reason? }; there are no other fields.

Response

Returns 201 Created with the created duplicate report, including its reportId and initial state.

Example

curl -X POST https://api.mapping.travel/api/v1/reference/duplicates \
  -H "X-API-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "originalHotelId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "duplicateHotelId": "f7e6d5c4-b3a2-1098-fedc-ba9876543210",
    "duplicateSourceId": "expedia",
    "reason": "Same address and coordinates, name differs only by punctuation."
  }'

Error responses

Status	Reason
`400 Bad Request`	Missing required IDs, or `originalHotelId` equals `duplicateHotelId`.
`401 Unauthorized`	Missing or invalid `X-API-Key` header.
`404 Not Found`	One of the referenced reference hotels does not exist.

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

POST /api/v1/reference/duplicates

Request body

Response

Example

Error responses

​POST /api/v1/reference/duplicates

​Request body

​Response

​Example

​Error responses

POST /api/v1/reference/duplicates

Request body

Response

Example

Error responses