Query raw ingested records

1 min

GET

https://app.amberflo.io/usage/events

Retrieves raw events (records) sent to the ingest API for inspection and debugging. Provides direct access to meter data as it was originally submitted.

Important limitations:

Time range constraints: Maximum query span depends on event frequency and filters applied
Squashed events: For squashable meters, only the final squashed event is available, not individual records
High-frequency exclusions: Events from very high-frequency meters may not be available for query

Cost considerations: Query cost is determined by data scanned. Narrower time ranges and specific filters reduce costs significantly.

Typical use cases:

Debug ingestion issues and validate event data
Audit customer usage patterns and dimension values
Analyze raw event structure before aggregation
Troubleshoot missing or incorrect meter data

meterApiNamestringTechnical identifier of the meter to query events from. Must match existing meter in your account.

customerIdstringUnique identifier of the customer whose events to retrieve for filtering.

eventIdstringSpecific event identifier to filter results by when querying individual events.

startTimeInSecondsinteger<int64>Unix timestamp marking the earliest time boundary for event retrieval (inclusive).

endTimeInSecondsinteger<int64>Unix timestamp marking the latest time boundary for event retrieval (exclusive).

limitintegerMaximum number of events to return in total across all pages.

pageSizeintegerNumber of events to return per page for pagination control.

isAscendingbooleanWhether to sort events by timestamp in ascending order (true) or descending order (false).

nextPageTokenstringPagination token returned from previous response to retrieve the next page of results.

200Successful request

curl --request GET \
     --url 'https://app.amberflo.io/usage/events?pageSize=100' \
     --header 'accept: application/json'