---
title: "List File Upload Jobs"
method: GET
path: "/organizations/{orgId}/fileuploads/measurements/jobs"
tags: ["Measurements"]
---

# List File Upload Jobs

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

## Request

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

Lists the File Upload jobs. Part of the File Upload service for measurements ingest:
* You can use the `dateCreatedStart` and `dateCreatedEnd` optional Query parameters to define a date range to filter the File Uploads jobs returned for this call.
* If `dateCreatedStart` and `dateCreatedEnd` Query parameters are not used, then all File Upload jobs are returned.

## Path parameters

- `orgId` string, required

## Query parameters

- `pageSize` integer
- `nextToken` string
- `dateCreatedStart` string
- `dateCreatedEnd` string
- `fileKey` string, nullable

## Response `200`

Return the list of File Upload jobs.

- PaginatedUploadJobResponseData
  - `data` UploadJobResponse[]
    - `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.
  - `nextToken` string

## Other responses

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

## Changes

- **2026-10-16** `85c514abc692`: 1 info
  - removed `subschema #2` from the `data/items/status` response property `allOf` list for the response status `200`
- **2025-08-01** `9f9e5f3dbde7`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `data` to the response with the `200` status
  - added the optional property `nextToken` to the response with the `200` status
- **2025-02-21** `d064a12d0d93`: 1 warning
  - deleted the `path` request parameter `orgId`
- **2025-02-04** `9433593378b5`: 2 breaking, 2 warning, 1 info
  - added the new path request parameter `orgId`
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `nextToken` from the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/fileuploads/measurements/jobs/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)