> ## Documentation Index
> Fetch the complete documentation index at: https://velt-mintlify-e6426361.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get knowledge ingest status (v2)

> Poll the status of a Memory knowledge ingestion job started via the ingest endpoint using the Velt v2 REST API to track parsing, chunking, and indexing.

Use this API to poll the status of an ingestion started with [Ingest Knowledge](/api-reference/rest-apis/v2/memory/knowledge/ingest).

# Endpoint

`POST https://api.velt.dev/v2/memory/knowledge/ingest-status`

# Headers

<ParamField header="x-velt-api-key" type="string" required>
  Your API key.
</ParamField>

<ParamField header="x-velt-auth-token" type="string" required>
  Your [Auth Token](/security/auth-tokens).
</ParamField>

# Body

#### Params

<ParamField body="data" type="object" required>
  <Expandable title="properties">
    <ParamField body="sourceId" type="string" required>
      The knowledge source id returned by Ingest Knowledge.
    </ParamField>
  </Expandable>
</ParamField>

## **Example Requests**

#### Poll an ingestion

```JSON theme={null}
{
  "data": {
    "sourceId": "src_9a8..."
  }
}
```

# Response

`status` is `processing`, `completed`, or `failed`. On `failed`, a `failureReason` is included. `dedupOf` is set when the file was a duplicate of an existing source; when it is, the reported `status`, counts, and download URLs mirror that winning source's live state, not the duplicate's own. A freshly uploaded duplicate therefore reports `processing` until the original finishes converting, then flips to `completed`. Keep polling until the status is terminal before downloading.

#### Success Response

```JSON theme={null}
{
  "result": {
    "status": "completed",
    "sourceId": "src_9a8...",
    "startedAt": 1731432000000,
    "updatedAt": 1731432041000,
    "mimeType": "application/pdf",
    "extractedRulesCount": 7,
    "chunkCount": 0,
    "originalDownloadUrl": "https://storage.googleapis.com/...",
    "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
  }
}
```

#### Failure Response

```JSON theme={null}
{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}
```

<ResponseExample>
  ```js theme={null}
  {
    "result": {
      "status": "completed",
      "sourceId": "src_9a8...",
      "startedAt": 1731432000000,
      "updatedAt": 1731432041000,
      "mimeType": "application/pdf",
      "extractedRulesCount": 7,
      "chunkCount": 0,
      "originalDownloadUrl": "https://storage.googleapis.com/...",
      "canonicalMdDownloadUrl": "https://storage.googleapis.com/..."
    }
  }
  ```
</ResponseExample>