# Get Ingestion Status

`GET /accounting/usages/ingestions`

Group: Accounting › Usage · Operation ID: `getIngestionStatus`

Returns the processing status of the usage ingestion job with the given dataExtractionId.

[Open in the interactive reference](https://docs.api.lensing.ai/?op=getIngestionStatus)

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Api-Version` | header | `"v1"` | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version `v1`. |
| `dataExtractionId` | query | number | yes | The identifier of the ingestion job to check, returned by POST accounting/usages/ingest. |

## Response

`200` Success

Under `data` (getIngestionStatusOutput):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object or null | no | The status of the ingestion job. Null when no job matches dataExtractionId. |
| `data.dataExtractionId` | number | yes | The identifier of the ingestion job, returned unchanged. |
| `data.name` | string | no | The name recorded for this ingestion, usually the original file name. Absent when none is set. |
| `data.mapping` | string | yes | The column mapping applied to this ingestion. An empty string when the default schema was used. |
| `data.extractedData` | array of object | yes | The per-record outcomes, one entry for each row of the ingested payload. |
| `data.extractedData[].everestId` | number | no | The internal identifier assigned to the row once it is processed. Absent until then. |
| `data.extractedData[].status` | string | yes | The processing status of this row, for example 'PENDING', 'Staged', 'Integrated' or 'FAILED'. |
| `data.extractedData[].isActive` | boolean | yes | Whether this row is currently active. An inactive row stays visible for audit but is left out of downstream billing. |
| `data.extractedData[].error` | string | no | The reason the row failed. Present only when status is a failure. |
| `data.extractedData[].trackId` | string | no | The trackId you supplied for this row at ingestion. Absent when you supplied none. |

## Errors

| Code | Status |
| --- | --- |
| `MULTIPLE_UPLOADS_FOUND` | 400 |

## Statuses

- `400` — Invalid request or business failure. Codes: MULTIPLE_UPLOADS_FOUND
- `401` — Missing or invalid access token
- `403` — Not authorized
- `404` — Not found
- `429` — Too many requests
- `500` — Internal server error