WEweld
Usage

Get Usage

Changed on

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.

get/usage

Request

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

Query parameters

start_datestring
Example:2026-10-01

First day of the period, as a UTC date. Set together with end_date; when both are omitted, the period is the current usage period. Must be within the last 6 months.

end_datestring
Example:2026-11-01

Day after the last day of the period, as a UTC date (exclusive). Set together with start_date.

Response

synced_rowsnumber required

Rows synced in the period.

active_rowsnumber required

Billed Monthly Active Rows (MAR) in the period.

period_startstring required

Start of the period (inclusive).

period_endstring required

End of the period (exclusive).

active_rows_limitnumber nullable required

Monthly Active Rows included in the account's current plan per usage period. Null when the plan has no limit.

Example response

{
  "synced_rows": 120000,
  "active_rows": 45000,
  "period_start": "2026-10-15T00:00:00.000Z",
  "period_end": "2026-11-15T00:00:00.000Z",
  "active_rows_limit": 1000000,
  "elt": {
    "synced_rows": 120000,
    "active_rows": 45000,
    "main_table": {
      "synced_rows": 120000,
      "active_rows": 45000
    },
    "history_table": {
      "synced_rows": 120000,
      "active_rows": 45000
    },
    "sub_tables": {
      "synced_rows": 120000,
      "active_rows": 45000
    },
    "extra_destination_active_rows": 2500
  },
  "reverse_etl": {
    "synced_rows": 120000,
    "active_rows": 45000
  },
  "integrations": [
    {
      "synced_rows": 120000,
      "active_rows": 45000,
      "integration_id": "shopify"
    }
  ],
  "elt_streams": [
    {
      "synced_rows": 120000,
      "active_rows": 45000,
      "main_table": {
        "synced_rows": 120000,
        "active_rows": 45000
      },
      "history_table": {
        "synced_rows": 120000,
        "active_rows": 45000
      },
      "sub_tables": {
        "synced_rows": 120000,
        "active_rows": 45000
      },
      "extra_destination_active_rows": 2500,
      "elt_sync_id": "vBjnEbMi9i3P4K",
      "integration_id": "shopify",
      "source_stream": "orders"
    }
  ],
  "reverse_etl_objects": [
    {
      "synced_rows": 120000,
      "active_rows": 45000,
      "reverse_etl_sync_id": "Kq8LmZ2xT4bNpe",
      "integration_id": "hubspot",
      "destination_object": "contact"
    }
  ]
}

Changes