Retrieve an upload
Authorizations
OptimalDial API key, prefixed od_live_, sent as Authorization: Bearer ....
Mint keys in the in-app developer panel; they are scoped to a single organization.
Path Parameters
Response
The upload.
cancelled is a legacy value retained so historical uploads still
parse — no new upload can enter it.
pending_mapping, validating, validation_failed, awaiting_confirmation, ready_for_processing, processing, completed, failed, cancelled Credits returned to the organization when OptimalDial refunds an upload.
web for in-app uploads, api for direct /api/v1/uploads calls,
api_pool for uploads synthesized from the Contacts API.
web, api, api_pool, null Validation tier used for this upload (standard or max).
standard, max, null Whether OptimalDial Identity was requested for this upload, i.e. a name column was mapped at creation.
Distribution of the results, populated once status == "completed". Lets you see the shape of a list without downloading it.
How many times these results have been downloaded, counting both the web app and this API.
true once the processed file can be downloaded. Storage keys are deliberately not exposed — use the download endpoints.
true once the deprecated download/processed-filtered endpoint will succeed, whether from a stored file or generated on demand.