> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maximem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# memories.status

> Check the progress of an asynchronous ingestion job.

```python theme={null}
await sdk.memories.status(ingestion_id)
```

Check the progress of an asynchronous ingestion job. Use the `ingestion_id` returned by [`memories.create`](/sdk-reference/memories/create), [`memories.batch_create`](/sdk-reference/memories/batch-create), or [`memories.create_from_file`](/sdk-reference/memories/create-from-file).

### Parameters

<ParamField path="ingestion_id" type="UUID" required>
  The ingestion job ID returned from a create call.
</ParamField>

### Returns

`MemoryStatusResponse` with the job's current state and the IDs of any memories it has produced so far.

<ResponseField name="ingestion_id" type="UUID">
  The ingestion job identifier.
</ResponseField>

<ResponseField name="document_id" type="string">
  The document identifier associated with this ingestion.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the ingestion job.

  | Value             | Description                                                                      |
  | ----------------- | -------------------------------------------------------------------------------- |
  | `queued`          | Document is waiting to be processed                                              |
  | `processing`      | Document is currently being processed through the pipeline                       |
  | `completed`       | All extraction and storage stages completed successfully                         |
  | `failed`          | Processing failed. Check `error_message` for details.                            |
  | `partial_success` | Some extractions succeeded but others failed. Check `error_message` for details. |
</ResponseField>

<ResponseField name="queued_at" type="datetime">
  Timestamp when the job was queued.
</ResponseField>

<ResponseField name="started_at" type="datetime">
  Timestamp when processing started, or `None` if still queued.
</ResponseField>

<ResponseField name="completed_at" type="datetime">
  Timestamp when processing finished, or `None` if still in progress.
</ResponseField>

<ResponseField name="memories_created" type="integer">
  Number of memories produced from this ingestion so far.
</ResponseField>

<ResponseField name="memory_ids" type="List[UUID]">
  IDs of memories produced from this ingestion. You can pass these to [`memories.get`](/sdk-reference/memories/get).
</ResponseField>

<ResponseField name="error_message" type="string">
  Error description if `status` is `failed` or `partial_success`; otherwise `None`.
</ResponseField>

### Example

```python theme={null}
from maximem_synap import MaximemSynapSDK

sdk = MaximemSynapSDK(api_key="synap_your_key_here")
await sdk.initialize()

status = await sdk.memories.status(result.ingestion_id)
print(status.status)            # e.g. "completed"
print(status.memories_created)  # e.g. 3
print(status.memory_ids)        # list of UUIDs
```

### Raises

* `SynapAuthError`: when the API key is missing or invalid.
* `SynapNotFoundError`: when the `ingestion_id` is unknown.

### See also

* [memories.wait\_for\_completion](/sdk-reference/memories/wait-for-completion)
* [memories.create](/sdk-reference/memories/create)
* [memories.get](/sdk-reference/memories/get)