v1

latestOpenAPI 3.0.32026-08-068925782.3 MB
Usage Reporting

Paginated list of row-level validation errors for a Usage File.

Unions three existing error sources:

  • UsageFile.error_detail (file-level — one entry, row=None)
  • UsageRecord.error_details/codes (per-record invalid rows)
  • ItemCreationErrors (dynamic-item creation failures)

Each entry mapped to {column?, code, message, raw_value?}. The row field is omitted because source-row index isn't persisted today.

Each per-row source is capped at VALIDATION_ERRORS_MAX_PER_SOURCE to bound memory and DB I/O for pathologically invalid files. Beyond that cap callers see a representative sample; the response's truncated flag is set so they know more errors exist.

total is the count of errors collected into this response (what the items are paginated over). When truncated is true the real number of errors in the DB is higher than total; we intentionally do not run a COUNT(*) to surface it (see the cap + 1 fetch below).

get/usage/files/{id}/validation-errors

Path parameters

idstring required

A unique value identifying this Usage File.

Response

idstring
namestring nullable
external_idstring required
status'draft' | 'uploading' | 'uploaded' | 'invalid' | 'processing' | 'ready' | 'rejected' | 'pending' | 'accepted' | 'closed' | 'deleted'
environment'test' | 'preview' | 'production'
error_detailstring nullable
descriptionstring nullable
acceptance_notestring nullable
rejection_notestring nullable
schema'tr' | 'pr' | 'qt' | 'cr'
currencystring nullable
sub_status'processing' | 'processed' nullable
usage_file_uristring
processed_file_uristring
reconciliation_file_uristring
start_datetime_utcstring date-time
end_datetime_utcstring date-time