Get a copy

GET/collection/items/{id}

Signed in

One of your copies. Its history: /changes; its codes: /codes; what it’s worth over time: GET /insights/items/{id}.

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

Path parameters

idstring (uuid)required

Responses

200OKThe copy.

Copy

A copy in your collection (owned or sold).

idstring (uuid)required
statusenumrequired
One ofownedsold
issueCopyIssueRefrequired
editionCopyEditionRef or nullrequired
coverUrlstring (uri) or nullrequired
currencystringrequired
The copy’s currency: its purchase, asking and own-value amounts are in it.
gradenumber or nullrequired
gradingCompanystring or nullrequired
certNumberstring or nullrequired
certStatusstring or nullrequired
pageQualitystring or nullrequired
isSignedbooleanrequired
signaturesarray of stringrequired
signatureAuthenticationstring or nullrequired
isRestoredbooleanrequired
copyLabelstring or nullrequired
isLabeledbooleanrequired
It has a printed QR label.
purchasePriceMoney or nullrequired
acquiredOnstring (date) or nullrequired
acquiredFromstring or nullrequired
salePriceMoney or nullrequired
soldOnstring (date) or nullrequired
forTradebooleanrequired
askingPriceMoney or nullrequired
valueobjectrequired
What it’s worth (GET /insights/items/{id} has the history and the sales behind it).
ShowHide the fields of value
- estimateMoney or nullrequired
  Your own value when you set one, else the market estimate.
- marketMoney or nullrequired
- lowMoney or nullrequired
- highMoney or nullrequired
- ownMoney or nullrequired
- ownNotestring or nullrequired
- methodstring or nullrequired
- confidencenumber or nullrequired
- updatedAtstring (date-time) or nullrequired
locationstring or nullrequired
tagsarray of stringrequired
notesstring or nullrequired
readStatusstring or nullrequired
ratinginteger or nullrequired
isHiddenbooleanrequired
codesarray of stringrequired
Barcodes and other codes on it and its edition.
sourcestring or nullrequired
createdAtstring (date-time)required
updatedAtstring (date-time)required

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 copy_not_found
not_found: Nothing at that address.
copy_not_found: No copy of yours with that id.
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' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "id": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90",
  "status": "owned",
  "issue": {
    "id": "3c7a9e1f-2b4d-4f6a-8e0c-5d7b9a1c3e5f",
    "number": "1",
    "title": "Rubicon",
    "kind": "regular",
    "coverDate": "1991-10-01",
    "isKey": true,
    "keyNotes": null,
    "series": {
      "id": "9d5e1c2a-7b4f-4e3a-8c6d-1a2b3c4d5e6f",
      "title": "X-Men",
      "slug": "x-men-1991",
      "startYear": 1991,
      "volume": 2
    },
    "publisher": {
      "id": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e",
      "name": "Marvel"
    },
    "url": "/catalog/series/x-men-1991/1"
  },
  "edition": {
    "id": "5e8b2d4f-6a1c-4e3b-9d7f-0a2c4e6b8d1f",
    "name": "Cover E Gatefold",
    "coverVariant": "E",
    "printing": 1,
    "distribution": "direct_market",
    "release": null
  },
  "coverUrl": "https://covers.collection.id/i/x-men-1991-1-e.webp?t=…",
  "currency": "USD",
  "grade": 9.4,
  "gradingCompany": "cgc",
  "certNumber": "1234567001",
  "certStatus": "verified",
  "pageQuality": "white",
  "isSigned": false,
  "signatures": [],
  "signatureAuthentication": null,
  "isRestored": false,
  "copyLabel": null,
  "isLabeled": true,
  "purchasePrice": {
    "amountCents": 4500,
    "currency": "USD"
  },
  "acquiredOn": "2024-06-02",
  "acquiredFrom": "Local shop",
  "salePrice": null,
  "soldOn": null,
  "forTrade": false,
  "askingPrice": null,
  "value": {
    "estimate": {
      "amountCents": 6000,
      "currency": "USD"
    },
    "market": {
      "amountCents": 6000,
      "currency": "USD"
    },
    "low": {
      "amountCents": 5000,
      "currency": "USD"
    },
    "high": {
      "amountCents": 7000,
      "currency": "USD"
    },
    "own": null,
    "ownNote": null,
    "method": "recent_sales",
    "confidence": 0.8,
    "updatedAt": "2026-10-11T06:47:11.610Z"
  },
  "location": "Slab case 1",
  "tags": [
    "keys"
  ],
  "notes": null,
  "readStatus": null,
  "rating": null,
  "isHidden": false,
  "codes": [],
  "source": "api",
  "createdAt": "2026-10-11T06:47:11.610Z",
  "updatedAt": "2026-10-11T06:47:11.610Z"
}

Responses

200OKThe copy.

Copy

A copy in your collection (owned or sold).

idstring (uuid)required
statusenumrequired
One ofownedsold
issueCopyIssueRefrequired
editionCopyEditionRef or nullrequired
coverUrlstring (uri) or nullrequired
currencystringrequired
The copy’s currency: its purchase, asking and own-value amounts are in it.
gradenumber or nullrequired
gradingCompanystring or nullrequired
certNumberstring or nullrequired
certStatusstring or nullrequired
pageQualitystring or nullrequired
isSignedbooleanrequired
signaturesarray of stringrequired
signatureAuthenticationstring or nullrequired
isRestoredbooleanrequired
copyLabelstring or nullrequired
isLabeledbooleanrequired
It has a printed QR label.
purchasePriceMoney or nullrequired
acquiredOnstring (date) or nullrequired
acquiredFromstring or nullrequired
salePriceMoney or nullrequired
soldOnstring (date) or nullrequired
forTradebooleanrequired
askingPriceMoney or nullrequired
valueobjectrequired
What it’s worth (GET /insights/items/{id} has the history and the sales behind it).
ShowHide the fields of value
- estimateMoney or nullrequired
  Your own value when you set one, else the market estimate.
- marketMoney or nullrequired
- lowMoney or nullrequired
- highMoney or nullrequired
- ownMoney or nullrequired
- ownNotestring or nullrequired
- methodstring or nullrequired
- confidencenumber or nullrequired
- updatedAtstring (date-time) or nullrequired
locationstring or nullrequired
tagsarray of stringrequired
notesstring or nullrequired
readStatusstring or nullrequired
ratinginteger or nullrequired
isHiddenbooleanrequired
codesarray of stringrequired
Barcodes and other codes on it and its edition.
sourcestring or nullrequired
createdAtstring (date-time)required
updatedAtstring (date-time)required

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 copy_not_found
not_found: Nothing at that address.
copy_not_found: No copy of yours with that id.
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).

{ "id": "6f2c0a4e-3b1d-4c8e-9a7f-2d5e8b1c4a90", "status": "owned", "issue": { "id": "3c7a9e1f-2b4d-4f6a-8e0c-5d7b9a1c3e5f", "number": "1", "title": "Rubicon", "kind": "regular", "coverDate": "1991-10-01", "isKey": true, "keyNotes": null, "series": { "id": "9d5e1c2a-7b4f-4e3a-8c6d-1a2b3c4d5e6f", "title": "X-Men", "slug": "x-men-1991", "startYear": 1991, "volume": 2 }, "publisher": { "id": "0b4f3b1e-6c1a-4f5e-9f0e-1f2a3b4c5d6e", "name": "Marvel" }, "url": "/catalog/series/x-men-1991/1" }, "edition": { "id": "5e8b2d4f-6a1c-4e3b-9d7f-0a2c4e6b8d1f", "name": "Cover E Gatefold", "coverVariant": "E", "printing": 1, "distribution": "direct_market", "release": null }, "coverUrl": "https://covers.collection.id/i/x-men-1991-1-e.webp?t=…", "currency": "USD", "grade": 9.4, "gradingCompany": "cgc", "certNumber": "1234567001", "certStatus": "verified", "pageQuality": "white", "isSigned": false, "signatures": [], "signatureAuthentication": null, "isRestored": false, "copyLabel": null, "isLabeled": true, "purchasePrice": { "amountCents": 4500, "currency": "USD" }, "acquiredOn": "2024-06-02", "acquiredFrom": "Local shop", "salePrice": null, "soldOn": null, "forTrade": false, "askingPrice": null, "value": { "estimate": { "amountCents": 6000, "currency": "USD" }, "market": { "amountCents": 6000, "currency": "USD" }, "low": { "amountCents": 5000, "currency": "USD" }, "high": { "amountCents": 7000, "currency": "USD" }, "own": null, "ownNote": null, "method": "recent_sales", "confidence": 0.8, "updatedAt": "2026-10-11T06:47:11.610Z" }, "location": "Slab case 1", "tags": [ "keys" ], "notes": null, "readStatus": null, "rating": null, "isHidden": false, "codes": [], "source": "api", "createdAt": "2026-10-11T06:47:11.610Z", "updatedAt": "2026-10-11T06:47:11.610Z" }