---
title: "Export meter readings"
method: GET
path: "/meter_readings/export"
tags: ["meter_readings"]
---

# Export meter readings

`GET /meter_readings/export`

## Request

- Base URL: `https://app.torgix.ai/v1`
- URL: `https://app.torgix.ai/v1/meter_readings/export`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.torgix.ai/oauth/authorize`, token URL `https://app.torgix.ai/oauth/token`, scopes: `export`)

Bulk pull (JSON array, or `?format=ndjson` with an `X-Truncated` header), capped at 2000 rows per call with a `truncated` flag. The same filters, `fields` and `changed_since` apply.

## Query parameters

- `fields` string
- `changed_since` string, date-time
- `include_deleted` boolean
- `format` 'json' | 'ndjson'

## Response `200`

Exported rows.

- object
  - `data` object[]
  - `count` integer
  - `truncated` boolean
  - `max` integer
  - `request_id` string

## Other responses

- `401`: Missing or invalid credentials.
- `403`: API access not enabled for the account, missing scope, or IP not allowlisted.
- `429`: Per-second rate limit exceeded.

---

[API](https://skmtc.dev/torgix/apis/torgix-api.md) · [All operations](https://skmtc.dev/torgix/apis/torgix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/torgix/apis/torgix-api/revisions/e675a45c026d?raw)
