List contact imports

GEThttps://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

pageintegeroptionalDefault: 1

Page number (1-indexed).

min: 1

perPageintegeroptionalDefault: 20

Results per page (max 100).

min: 1 · max: 100

Response

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

Show response fields

importsarray<object>

Show child attributes

completedAtstringdate-time

createdAtstringdate-time

createdCountinteger

engineVersionstring

errorCountinteger

filenamestring

idstring

skippedCountinteger

statusstring

totalRowsinteger

RequestGET/v1/contact-imports/curl

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

Response200

{
  "success": true,
  "data": {
    "imports": [
      {
        "id": "dimp_1",
        "filename": "contacts.csv",
        "totalRows": 47,
        "createdCount": 40,
        "skippedCount": 1,
        "errorCount": 0,
        "status": "completed",
        "engineVersion": "1.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
  }
}