---
title: "Get Failed Ingest File Download URL"
method: GET
path: "/organizations/{orgId}/measurements/failedIngest/getDownloadUrl"
tags: ["Measurements"]
---

# Get Failed Ingest File Download URL

`GET /organizations/{orgId}/measurements/failedIngest/getDownloadUrl`

## Request

- Base URL: `https://api.m3ter.com`
- URL: `https://api.m3ter.com/organizations/{orgId}/measurements/failedIngest/getDownloadUrl`
- Auth: OAuth 2
  - Authorization code: `https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/authorize`, token URL `https://m3ter.auth.us-east-1.amazoncognito.com/oauth2/token`
  - Client credentials, token URL `/oauth/token`
  - Scopes: `measurements:retrieve`
- TypeScript: <https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/measurements/failedIngest/getDownloadUrl/get.ts> (a function with typed inputs; its response is checked against the schema)

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](https://www.m3ter.com/docs/api#tag/Events/operation/ListEventFields) 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.

## Path parameters

- `orgId` string, required

## Query parameters

- `file` string

## Response `200`

Returns a presigned URL for failed ingest file download

- GenerateDownloadUrlResponse: It contains details for downloading a file
  - `url` string: The presigned download URL

## Other responses

- `4XX`: Error message
- `5XX`: Error message

---

[API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) - [All operations](https://skmtc.dev/m3ter-com/apis/m3ter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/m3ter-com/apis/m3ter-api/revisions/85c514abc692?raw)