Read stored daily native network reporting

GET/reports/networking

Bounded grouped report page. Reuses reports:read authentication and independently requires networking_reporting entitlement. No provider calls. ClickHouse applies grouping, sorting and bounded LIMIT/OFFSET. Optional snapshot detects changed accepted data or query between pages; mismatch returns 409 and callers restart at offset zero. Without snapshot each page reads current accepted data, so concurrent refreshes can shift page boundaries. Exact filters use repeated filter.FIELD parameters; is_null=FIELD selects unknowns. Currency and source_timezone always group. Unknown currencies additionally retain provider and full native account identity. Counts serialize as decimal strings. CSV null is backslash N; strings starting with backslash gain one backslash. See the networking output contract for the full dimension allowlist.

Request

cURL
curl -X GET "https://provisioning.cloudx.io/api/v1/reports/networking?start_date=<start_date>&end_date=<end_date>" \
  -H "Authorization: Bearer $CLOUDX_API_KEY"

Query parameters

NameTypeDescription
start_daterequiredstring<date>
end_daterequiredstring<date>
dimensionsstring
formatstringAllowed values: json, csv.
account_idstring
is_nullarray of string
limitinteger
offsetinteger
sort_bystringAggregate revenue sort; absent uses ascending effective grouping fields, NULL last Allowed values: revenue.
sort_orderstringRequires sort_by; revenue NULLs remain last and grouping fields break ties Allowed values: asc, desc.
snapshotstringOptional first-page fingerprint; query and accepted data must remain unchanged

Responses

Bounded page with range coverage; empty pages may follow the last result
{
  "query_time": "<string>",
  "fields": [
    "<string>"
  ],
  "rows": [
    {}
  ],
  "coverage": [
    {}
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "has_more": true,
    "snapshot": "<string>"
  }
}

200 Bounded page with range coverage; empty pages may follow the last result

FieldTypeDescription
query_timerequiredstring<date-time>
fieldsrequiredarray of string
rowsrequiredarray of object
coveragerequiredarray of object
pagerequiredobject

400 Invalid fields

401 Authentication required

403 Permission or independent entitlement denied

409 Snapshot changed; restart the traversal from offset zero

422 Explicit report cap exceeded; narrow dates or filters

503 Retryable target unreadiness or query unavailable