List contact imports

GET https://app.speybooks.com/api/v1/contact-imports/

Retrieve a paginated list of contact imports for the current organisation, ordered by creation date descending. Default pagination: page 1, 20 per page (max 100).

Query parameters

page integer optional Default: 1

Page number (1-indexed).

min: 1

perPage integer optional Default: 20

Results per page (max 100).

min: 1 · max: 100

Response

200 Paginated list of contact imports with meta (page, perPage, total, pages).

Show response fields

imports array<object>

Show child attributes

completedAt string date-time

createdAt string date-time

createdCount integer

engineVersion string

errorCount integer

filename string

id string

skippedCount integer

status string

totalRows integer

Request GET /v1/contact-imports/ curl

curl https://api.speybooks.com/v1/contact-imports?page=1&perPage=20 \
  -H "Authorization: Bearer sk_live_..."

Response 200

{
  "success": true,
  "data": {
    "imports": [
      {
        "id": "dimp_1",
        "filename": "contacts.csv",
        "totalRows": 47,
        "createdCount": 40,
        "skippedCount": 1,
        "errorCount": 0,
        "status": "completed",
        "engineVersion": "4.0.0",
        "createdAt": "2026-02-19T10:00:00.000Z",
        "completedAt": "2026-02-19T10:05:00.000Z"
      }
    ]
  },
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "pages": 1
  }
}