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

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