List your copies

GET/collection/items

Signed inPaginated: cursor

The copies you own or sold, newest first by default. Filter by what they are, where they are and how they’re graded; sort by title, value, grade or date. Your wishlist is GET /wishlist.

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

Query parameters

cursorstring
The nextCursor of the previous page. Omit for the first page.
at most 1000 characters
limitinteger
Items per page, 1–200 (default 50).
1–200 · default 50
sortstring
Sort by createdAt, updatedAt, title, value, grade, acquiredOn; a leading "-" sorts descending, a comma adds a tiebreak. Default -createdAt.
at most 200 characters
filter[status]enum
Owned or sold copies only.
One ofownedsold
filter[series]string (uuid)
Copies of this series’ issues.
filter[issue]string (uuid)
Copies of this issue.
filter[edition]string (uuid)
Copies of this edition.
filter[publisher]string (uuid)
Copies of this publisher’s books.
filter[location]string
In this place (its name, any case).
1–120 characters
filter[tag]string
With this tag.
1–100 characters
filter[graded]enum
Slabbed (graded and encapsulated) or raw.
One ofslabbedraw
filter[gradingCompany]enum
One ofcgccbcspsapgxegshga
and 1 more
other
filter[isKey]enum
Copies of key issues.
One of01truefalse
filter[isSigned]enum
Signed copies.
One of01truefalse
filter[forTrade]enum
Copies you’ve marked for trade.
One of01truefalse
filter[q]string
Words from the series, title, number or notes; or a barcode, ISBN or distributor code.
1–200 characters
filter[updatedSince]string (date-time)
Only rows changed at or after this time: sync what changed since your last run.
at most 64 characters

Responses

200OKA page of copies.

object

dataarray of Copyrequired
nextCursorstring or nullrequired
Pass as ?cursor= for the next page; null on the last page.

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

4Errors400 · 401 · 429 · 500

400
invalid_request invalid_cursor invalid_filter invalid_sort
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_cursor: The cursor isn’t one this list (in this order) gave out.
invalid_filter: A filter[field] the list doesn’t have, or a value it refuses.
invalid_sort: A sort field the list doesn’t have.
401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
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?limit=100&sort=title&filter%5Bseries%5D=9d5e1c2a-7b4f-4e3a-8c6d-1a2b3c4d5e6f' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "data": [
    {
      "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"
    }
  ],
  "nextCursor": null
}

Query parameters

cursorstring

The nextCursor of the previous page. Omit for the first page.

at most 1000 characters

limitinteger

Items per page, 1–200 (default 50).

1–200 · default 50

sortstring

Sort by createdAt, updatedAt, title, value, grade, acquiredOn; a leading "-" sorts descending, a comma adds a tiebreak. Default -createdAt.

at most 200 characters

filter[status]enum

Owned or sold copies only.

One ofownedsold

filter[series]string (uuid)

Copies of this series’ issues.

filter[issue]string (uuid)

Copies of this issue.

filter[edition]string (uuid)

Copies of this edition.

filter[publisher]string (uuid)

Copies of this publisher’s books.

filter[location]string

In this place (its name, any case).

1–120 characters

filter[tag]string

With this tag.

1–100 characters

filter[graded]enum

Slabbed (graded and encapsulated) or raw.

One ofslabbedraw

filter[gradingCompany]enum

One ofcgccbcspsapgxegshga

and 1 more

other

filter[isKey]enum

Copies of key issues.

One of01truefalse

filter[isSigned]enum

Signed copies.

One of01truefalse

filter[forTrade]enum

Copies you’ve marked for trade.

One of01truefalse

filter[q]string

Words from the series, title, number or notes; or a barcode, ISBN or distributor code.

1–200 characters

filter[updatedSince]string (date-time)

Only rows changed at or after this time: sync what changed since your last run.

at most 64 characters

Responses

200OKA page of copies.

object

dataarray of Copyrequired
nextCursorstring or nullrequired
Pass as ?cursor= for the next page; null on the last page.

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

4Errors400 · 401 · 429 · 500

400
invalid_request invalid_cursor invalid_filter invalid_sort
invalid_request: The query or body doesn’t match the schema (see errors[]).
invalid_cursor: The cursor isn’t one this list (in this order) gave out.
invalid_filter: A filter[field] the list doesn’t have, or a value it refuses.
invalid_sort: A sort field the list doesn’t have.
401
unauthorized
unauthorized: Not signed in (no session or token, or an expired one).
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).

{ "data": [ { "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" } ], "nextCursor": null }