# Imports

Imports in Prism — Micro Python reference.

Reference for Python SDK **0.8.0**.

[Release source](https://github.com/micro-so/micro-sdk-py/blob/v0.8.0/api.md) · [Setup and client configuration](/docs/reference/python)

## get

`GET /v2/prism/{teamId}/imports/{jobId}`

````text
client.prism.imports.get(job_id, *, team_id) -> ImportGetResponse
````

Poll the status of an async import. Sync imports complete in the original response and don't appear here. Async jobs are retained for 7 days. Returns 404 once the job has expired.

## Parameter and response types

These declarations show the request parameters and response shapes used by the methods above.

### Error

[Source](https://github.com/micro-so/micro-sdk-py/blob/v0.8.0/src/micro_so/types/prism/import_get_response.py)

Set when status=failed; describes the job-level failure (not per-row).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | `Optional[str]` | No | — |
| `message` | `Optional[str]` | No | — |

### ResultError

[Source](https://github.com/micro-so/micro-sdk-py/blob/v0.8.0/src/micro_so/types/prism/import_get_response.py)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | `Optional[str]` | No | — |
| `message` | `Optional[str]` | No | — |

### Result

[Source](https://github.com/micro-so/micro-sdk-py/blob/v0.8.0/src/micro_so/types/prism/import_get_response.py)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `Optional[str]` | No | — |
| `created` | `Optional[bool]` | No | — |
| `error` | `Optional[ResultError]` | No | — |
| `existing` | `Optional[bool]` | No | True if the row matched an existing record via the dedupe key. |

### ImportGetResponse

[Source](https://github.com/micro-so/micro-sdk-py/blob/v0.8.0/src/micro_so/types/prism/import_get_response.py)

Status snapshot of an import job. Same shape used by the POST /import response and by GET /imports/&#123;jobId&#125;.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `job_id` | `Optional[str]` | No | Null for sync imports (results inlined). Set for async imports. |
| `status` | `Literal["complete", "processing", "failed"]` | Yes | — |
| `total` | `int` | Yes | Total number of rows in the import. |
| `created_at` | `Optional[datetime]` | No | — |
| `error` | `Optional[Error]` | No | Set when status=failed; describes the job-level failure (not per-row). |
| `expires_at` | `Optional[datetime]` | No | — |
| `failed` | `Optional[int]` | No | — |
| `processed` | `Optional[int]` | No | Rows that have been attempted (succeeded + failed). |
| `results` | `Optional[List[Result]]` | No | Per-row outcomes. Always present for sync imports; populated for async imports once the job reaches `complete`. |
| `succeeded` | `Optional[int]` | No | — |
| `updated_at` | `Optional[datetime]` | No | — |
