# Files, Uploads, and Export

Source: https://help.zira.us/developers/api-reference/files-uploads-and-export
Summary: Reference the file lookup, signed-upload, import, and export endpoints used by SDK-driven file and reading flows.
Updated: 2026-03-26

## `GET /files/{fileId}`

Purpose:

- fetch one file by ID
- return resolved metadata and file URLs

Path params:

- `fileId`

Notes:

- the handler remaps `fileId` to the internal `id` field before querying

## `POST /files/signed-uploads/create`

Purpose:

- create signed upload instructions for client-side upload flows

Request notes:

- validates against the signed-upload schema
- if `originProperties` is sent as an object, it is stringified before processing

Typical body:

```json
{
  "name": "photo.jpg",
  "contentType": "image/jpeg",
  "originProperties": {
    "source": "android",
    "flow": "inspection"
  }
}
```

## `GET /import`

Purpose:

- return upload URL or upload data used by import workflows

## `GET /export`

Purpose:

- trigger readings export through the Meters-Data Lambda flow

Common query options:

- `meterId`
- `startTime`
- `endTime`

Alternative offset/time-window mode is also supported by the underlying implementation.

## Related endpoint

- `POST /files/attach/device/{id}` is documented in [Data Sources and Device APIs](/developers/api-reference/data-sources-and-devices)