v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB
Measurements

Get Failed Ingest File Download URL

Returns a presigned download URL for failed ingest file download based on the file path provided.

If a usage data ingest measurement you submit to the m3ter platform fails, an ingest.validation.failure Event is generated. Use this call to obtain a download URL which you can then use to download a file containing details of what went wrong with the attempted usage data measurement ingest, and allowing you to follow-up and resolve the issue.

To obtain the file query parameter:

  • Use the List Events call with the ingest.validation.failure for the eventName query parameter.
  • The response contains a getDownloadUrl response parameter and this contains the file path you can use to obtain the failed ingest file download URL.

Notes:

  • The presigned Url returned to use for failed ingest file download is time-bound and expires after 5 minutes.
  • If you make a List Events call for ingest.validation.failure Events in your Organization, then you can perform this GET call using the full URL returned for any ingest failure Event to obtain a failed ingest file download URL for the Event.
get/organizations/{orgId}/measurements/failedIngest/getDownloadUrl

Path parameters

orgIdstring required

UUID of the Organization

Query parameters

filestring

The file path

Response

Returns a presigned URL for failed ingest file download

urlstring

The presigned download URL