---
title: "Get Usage"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get Usage

`GET /usage`

## Request

- Base URL: `https://connect.weld.app`
- URL: `https://connect.weld.app/usage`
- Auth: API key in header `x-api-key`

Get the account's synced rows and billed Monthly Active Rows (MAR) for a period, in total and per Integration, per source stream of each ELT Sync and per destination object of each Reverse ETL Sync. ELT rows are split into main tables, history tables, sub-tables and extra ELT destinations. Defaults to the current usage period. Usage is aggregated hourly, so the latest runs may not be counted yet.

## Query parameters

- `start_date` string
- `end_date` string

## Response `200`

- UsageDto
  - `synced_rows` number, required: Rows synced in the period.
  - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
  - `period_start` string, required: Start of the period (inclusive).
  - `period_end` string, required: End of the period (exclusive).
  - `active_rows_limit` number, nullable, required: Monthly Active Rows included in the account's current plan per usage period. Null when the plan has no limit.
  - `elt` EltRowUsageDto, required
    - `synced_rows` number, required: Rows synced in the period.
    - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `main_table` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `history_table` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `sub_tables` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `extra_destination_active_rows` number, required: Active rows billed for loading into ELT destinations besides the data warehouse.
  - `reverse_etl` RowUsageDto, required
    - `synced_rows` number, required: Rows synced in the period.
    - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
  - `integrations` IntegrationUsageDto[], required: Rows per Integration, sorted by active rows in descending order.
    - `synced_rows` number, required: Rows synced in the period.
    - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `integration_id` string, required: The ID of the Integration.
  - `elt_streams` EltStreamUsageDto[], required: Rows per source stream of each ELT Sync, sorted by active rows in descending order. A stream's `active_rows` is the sum of its tables' `active_rows` and `extra_destination_active_rows`.
    - `synced_rows` number, required: Rows synced in the period.
    - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `main_table` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `history_table` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `sub_tables` RowUsageDto, required
      - `synced_rows` number, required: Rows synced in the period.
      - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `extra_destination_active_rows` number, required: Active rows billed for loading into ELT destinations besides the data warehouse.
    - `elt_sync_id` string, required: The ID of the ELT Sync.
    - `integration_id` string, required: The ID of the source Integration.
    - `source_stream` string, required: The name of the source stream.
  - `reverse_etl_objects` ReverseEtlObjectUsageDto[], required: Rows per destination object of each Reverse ETL Sync, sorted by active rows in descending order.
    - `synced_rows` number, required: Rows synced in the period.
    - `active_rows` number, required: Billed Monthly Active Rows (MAR) in the period.
    - `reverse_etl_sync_id` string, required: The ID of the Reverse ETL Sync.
    - `integration_id` string, required: The ID of the destination Integration.
    - `destination_object` string, required: The destination object the sync writes to, or the sheet label for a spreadsheet destination.

## Other responses

- `400`: The period is invalid or starts more than 6 months ago.

## Changes

- **2026-11-02** `0e768a2ead18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weld/apis/weld-rest-api/changes/usage/get.md)

---

[API](https://skmtc.dev/weld/apis/weld-rest-api.md) - [All operations](https://skmtc.dev/weld/apis/weld-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weld/apis/weld-rest-api/revisions/0e768a2ead18?raw)