Developers
Imports

List imports

GET/imports

Returns user imports created from spreadsheets, using cursor-based pagination.

Imports in the trash are excluded by default. Set deleted=true to list them.

The rows summary of each import reflects its analysis. To follow the processing state of individual rows, use the list import rows operation.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
sort?string

Value in

  • "id"
  • "-id"
type?string
status?string

Value in

  • "pending"
  • "analyzed"
  • "processing"
  • "processed"
  • "failed"
created_after?string
Formatdate-time
created_before?string
Formatdate-time
deleted?boolean

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/imports"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "current_operation_id": "string",      "deleted": true,      "duplicate_policy": "skip",      "failure_reason": "string",      "file_id": "string",      "id": "string",      "mapping": {        "email": "string",        "product_external_id": "string",        "status": "string"      },      "object": "import",      "revision": "string",      "rows": {        "ignored": 0,        "not_ready": 0,        "ready": 0,        "total": 0      },      "status": "pending",      "type": "students_access",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}

Imports

Imports in API v3: list imports, create an import, retrieve an import, update an import, delete an import, analyze an import, list processing attempts, create a processing attempt, retrieve a processing attempt, list import rows.

Create an import POST

Creates a user import from a spreadsheet that was previously uploaded with `purpose=import`. Creating an import does not process any rows. Request an analysis next, then start a processing attempt once the analysis is complete. If imports are disabled for the current account, the request is rejected with the `feature_disabled` error code.