List your imports

GET/collection/imports

Signed in

Your last 30 imports sent to the API, newest first, each with where it is and its counts.

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

Responses

200OKYour imports.

object

dataarray of ImportJobrequired
nextCursornullrequired
Always null: your last 30 imports come in one page.

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

3Errors401 · 429 · 500

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/imports' \
  -H "Authorization: Bearer $COLLECTOR_TOKEN"

{
  "data": [
    {
      "id": "2b7e4c1a-5d3f-4a8e-9c6b-0f1e2d3c4b5a",
      "status": "complete",
      "format": "generic",
      "fileName": "my-comics.csv",
      "options": {
        "defaultStatus": "owned",
        "needsReview": "skip"
      },
      "progress": {
        "phase": "done",
        "done": 2,
        "total": 2
      },
      "counts": {
        "rows": 4,
        "matched": 2,
        "needsReview": 1,
        "notFound": 1,
        "skipped": 0,
        "failed": 0,
        "created": 2,
        "existing": 0
      },
      "undo": {
        "href": "/api/v1/collection/imports/2b7e4c1a-5d3f-4a8e-9c6b-0f1e2d3c4b5a/undo",
        "until": "2026-11-11T09:30:00.000Z"
      },
      "error": null,
      "requestedAt": "2026-10-12T09:30:00.000Z",
      "startedAt": "2026-10-12T09:30:01.204Z",
      "completedAt": "2026-10-12T09:30:09.861Z"
    }
  ],
  "nextCursor": null
}

Responses

200OKYour imports.

object

dataarray of ImportJobrequired
nextCursornullrequired
Always null: your last 30 imports come in one page.

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

3Errors401 · 429 · 500

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": "2b7e4c1a-5d3f-4a8e-9c6b-0f1e2d3c4b5a", "status": "complete", "format": "generic", "fileName": "my-comics.csv", "options": { "defaultStatus": "owned", "needsReview": "skip" }, "progress": { "phase": "done", "done": 2, "total": 2 }, "counts": { "rows": 4, "matched": 2, "needsReview": 1, "notFound": 1, "skipped": 0, "failed": 0, "created": 2, "existing": 0 }, "undo": { "href": "/api/v1/collection/imports/2b7e4c1a-5d3f-4a8e-9c6b-0f1e2d3c4b5a/undo", "until": "2026-11-11T09:30:00.000Z" }, "error": null, "requestedAt": "2026-10-12T09:30:00.000Z", "startedAt": "2026-10-12T09:30:01.204Z", "completedAt": "2026-10-12T09:30:09.861Z" } ], "nextCursor": null }