Suggest what a copy could be

GET/collection/items/{id}/repoint

Signed in

Ranked issues to change the copy to before searching: what its barcodes name, the issues next to it, the same number in other volumes.

SDK method: collector.listCopyRepointOptions()
Key scopes: collection:read
Headers: If-None-MatchX-Request-Id

Path parameters

idstring (uuid)required

Responses

200OKSuggestions, best first.

object

suggestionsarray of CopyTargetOptionrequired
Best first.

304Not ModifiedNot modified: your copy (the ETag in If-None-Match) is current.

4Errors401 · 404 · 429 · 500

401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404
not_found
not_found: Nothing at that address.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

curl 'https://api.collection.id/v1/collection/items/6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90/repoint' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "suggestions": [
    {
      "issueId": "a2c4e6f8-1b3d-4f5a-8c7e-9d0b2f4a6c8e",
      "editionId": null,
      "issueLabel": "X-Men (1991) #2",
      "editionLabel": null,
      "coverUrl": "https://covers.collection.id/i/x-men-1991-2.webp",
      "ownCover": true,
      "reason": "Just after it in the series",
      "kind": "nearby"
    },
    {
      "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e",
      "editionId": null,
      "issueLabel": "X-Men (1963) #1",
      "editionLabel": null,
      "coverUrl": "https://covers.collection.id/i/x-men-1963-1.webp",
      "ownCover": true,
      "reason": "The same number in another volume",
      "kind": "volume"
    }
  ]
}

Responses

200OKSuggestions, best first.

object

suggestionsarray of CopyTargetOptionrequired
Best first.

304Not ModifiedNot modified: your copy (the ETag in If-None-Match) is current.

4Errors401 · 404 · 429 · 500

401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
404
not_found
not_found: Nothing at that address.
429
rate_limited temporarily_blocked
rate_limited: Over the caller’s limit: the per-minute burst or the per-day quota (RateLimit headers; wait Retry-After seconds).
temporarily_blocked: Too many refused requests in a row: blocked for a while (Retry-After says how long).
500
internal
internal: Something went wrong on our side (quote the requestId).

{ "suggestions": [ { "issueId": "a2c4e6f8-1b3d-4f5a-8c7e-9d0b2f4a6c8e", "editionId": null, "issueLabel": "X-Men (1991) #2", "editionLabel": null, "coverUrl": "https://covers.collection.id/i/x-men-1991-2.webp", "ownCover": true, "reason": "Just after it in the series", "kind": "nearby" }, { "issueId": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e", "editionId": null, "issueLabel": "X-Men (1963) #1", "editionLabel": null, "coverUrl": "https://covers.collection.id/i/x-men-1963-1.webp", "ownCover": true, "reason": "The same number in another volume", "kind": "volume" } ] }