> ## Documentation Index > Fetch the complete documentation index at: https://docs.tented.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get an import run > Fetch the status and progress counters of an import run. Runs move through `queued` → `running` → `completed` or `failed`. Rows are processed in chunks; `processed_rows`, `created_count`, `updated_count`, `skipped_count`, and `error_count` update as chunks complete, so you can poll this endpoint for live progress. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/contacts/imports/{importRunId} openapi: 3.1.0 info: title: Tented API version: 1.0.0 description: >- The Tented public API: generate, publish, and manage AI-built web pages (tents), and run the email platform — contacts, reusable emails, one-time blasts, and triggered flows. ## Authentication Authenticate every request with a workspace API key: `Authorization: Bearer `. Keys are created in **Workspace Settings → API Keys** and are scoped to a single workspace. ## Asynchronous work Tent generation, bulk creation, and email AI generation return `202 Accepted` immediately. Poll the corresponding status endpoint (`GET /v1/tents/{tentId}`, `GET /v1/bulk-jobs/{bulkJobId}`, `GET /v1/emails/{emailId}/generations/{generationId}`) — no more than every 10 seconds. ## Pagination Email listings use cursor pagination (`cursor`/`next_cursor`). Blast, flow, and member listings use page pagination (`page`/`limit` with a `pagination` object in the response). ## Conventions Request and response fields are snake_case, with two exceptions: analytics query parameters (`tentIdOrAlias`, `daysBack`) and segment rule trees (camelCase keys such as `listId` and `timeWindow`). contact: name: Tented Support email: support@tented.ai servers: - url: https://api.tented.ai description: Production security: - bearerAuth: [] tags: - name: Tents description: >- Create, edit, publish, and manage AI-generated pages, including asset uploads and bulk creation. - name: Analytics description: Traffic analytics for single tents and the whole workspace. - name: Contacts description: >- Batch create, update, and delete contacts. Up to 25 items per request with per-item results. - name: Emails description: >- Reusable email content: AI generation, direct HTML edits, plain-text control, and approval. - name: Email Blasts description: >- One-time sends to an audience: compose, schedule, track engagement, export recipients. - name: Triggered Flows description: >- Multi-step automations that enroll contacts on triggers and move them through a step graph. - name: Contact Imports - name: Contact Fields - name: Contact Lists - name: Email Templates - name: Tent Templates description: >- Reusable, AI-editable tent layouts. Create from HTML or an existing tent, iterate with AI, approve, and clone. Approved tent templates seed new tents. paths: /v1/contacts/imports/{importRunId}: get: tags: - Contact Imports summary: Get an import run description: >- Fetch the status and progress counters of an import run. Runs move through `queued` → `running` → `completed` or `failed`. Rows are processed in chunks; `processed_rows`, `created_count`, `updated_count`, `skipped_count`, and `error_count` update as chunks complete, so you can poll this endpoint for live progress. operationId: get-contact-import-run parameters: - name: importRunId in: path required: true schema: type: string format: uuid description: Import run ID from the execute response. responses: '200': description: Import run status and counters. content: application/json: schema: $ref: '#/components/schemas/ContactImportRun' '400': description: Bad request — invalid import run ID. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized — missing, malformed, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- Not found — the resource does not exist in the workspace tied to your API key. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: ContactImportRun: type: object properties: import_run_id: type: string format: uuid description: Import run ID. import_session_id: type: string format: uuid description: The import session the run was created from. file_name: type: string description: File name associated with the import session. status: type: string enum: - queued - running - completed - failed description: Run state. `queued` → `running` → `completed` or `failed`. requested_by_user_id: type: string description: Who started the run. `tented-api` for runs started via this API. duplicate_strategy: type: string enum: - update - skip description: How rows matching existing contacts were handled. overwrite_blank_only: type: boolean description: >- Whether imported values only filled empty fields on matched contacts. list_ids: type: array items: type: string format: uuid description: Static list IDs imported contacts were added to. total_rows: type: - integer - 'null' description: >- Total data rows in the source file, or `null` before preprocessing has counted them. total_chunks: type: integer description: >- Number of processing chunks the file was split into (rows are processed in chunks of up to 1,000). completed_chunks: type: integer description: Chunks processed successfully so far. failed_chunks: type: integer description: Chunks that failed. processed_rows: type: integer description: >- Data rows processed so far — compare against `total_rows` for progress. last_processed_row_number: type: integer description: Highest row number processed so far. created_count: type: integer description: Rows that created a new contact. updated_count: type: integer description: Rows that updated an existing contact. skipped_count: type: integer description: >- Rows skipped (e.g. duplicates under `duplicate_strategy: "skip"`, or rows with no usable identity). error_count: type: integer description: Rows that failed with an error. started_at: type: - string - 'null' format: date-time description: When processing started, or `null` while queued. completed_at: type: - string - 'null' format: date-time description: When the run completed, or `null`. failed_at: type: - string - 'null' format: date-time description: When the run failed, or `null`. failure_message: type: - string - 'null' description: Failure reason when `status` is `failed`. created_field_definition_ids: type: array items: type: string format: uuid description: Custom fields created during this import's setup. created_at: type: string format: date-time description: Creation time. updated_at: type: string format: date-time description: Last update. required: - import_run_id - import_session_id - status - requested_by_user_id - duplicate_strategy - overwrite_blank_only - list_ids - total_rows - total_chunks - completed_chunks - failed_chunks - processed_rows - last_processed_row_number - created_count - updated_count - skipped_count - error_count - started_at - completed_at - failed_at - failure_message - created_field_definition_ids - created_at - updated_at description: >- An import run: status, chunked-processing progress, and per-outcome row counts. Error: type: object properties: error: type: string description: Human-readable error message. error_code: type: string description: >- Stable machine-readable error code (present on email, blast, flow, and related endpoints, e.g. `campaign_not_ready`, `generation_in_progress`). message: type: string description: Additional human-readable context (present on some tent endpoints). code: type: string description: >- Machine-readable code used by tent creation errors (e.g. `INVALID_PROMPT_INTENT`). details: type: object additionalProperties: true description: >- Additional error context. Validation errors include `issues`: an array of `{ path, message }` objects. limit: type: integer description: Plan limit that was hit (present on `429` publish-limit errors). current: type: integer description: >- Current usage against the limit (present on `429` publish-limit errors). required: - error description: >- Error response. All errors include `error`; the other fields vary by endpoint group. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Workspace API key, e.g. `Authorization: Bearer tented_...`. Create keys in Workspace Settings → API Keys. ````