---
title: "Get File Upload Job Response"
method: GET
path: "/organizations/{orgId}/fileuploads/measurements/jobs/{id}"
tags: ["Measurements"]
---

# Get File Upload Job Response

`GET /organizations/{orgId}/fileuploads/measurements/jobs/{id}`

## Request

- Base URL: `https://api.m3ter.com`
- URL: `https://api.m3ter.com/organizations/{orgId}/fileuploads/measurements/jobs/{id}`
- 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:fileUpload`
- TypeScript: <https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/fileuploads/measurements/jobs/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the file upload job response using the UUID of the file upload job.

Part of the file upload service for measurements ingest.

## Path parameters

- `orgId` string, required
- `id` string, required

## Response `200`

Return the UploadJobResponse

- UploadJobResponse: Response containing the upload job details.
  - `id` string: UUID of the file upload job.
  - `version` integer: The version number. Default value when newly created is one.
  - `fileName` string: The name of the measurements file for the upload job.
  - `uploadDate` string: The upload date for the upload job *(in ISO-8601 format)*.
  - `contentLength` integer: The size of the body in bytes. For example: `"contentLength": 485`, where 485 is the size in bytes of the file uploaded.
  - `status` 'notUploaded' | 'running' | 'failed' | 'succeeded': The status of the file upload job.
  - `totalRows` integer: The total number of rows in the file.
  - `processedRows` integer: The number of rows that were processed during ingest.
  - `failedRows` integer: The number of rows that failed processing during ingest.

## Other responses

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

## Changes

- **2026-10-16** `85c514abc692`: 1 info
  - removed `subschema #2` from the `status` response property `allOf` list for the response status `200`
- **2025-02-21** `d064a12d0d93`: 1 warning
  - deleted the `path` request parameter `orgId`
- **2025-02-04** `9433593378b5`: 2 breaking, 5 info
  - added the new path request parameter `orgId`
  - the `status` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/JobStatus, subschema #2` to the `status` response property `allOf` list for the response status `200`
  - removed the `failed` enum value from the `status` response property for the response status `200`
  - …3 more

[Operation history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/fileuploads/measurements/jobs/:id/get.md)

---

[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)