UsageStats is a datatype for statistics of system usage. It's used by the usage() query field.

Table: UsageStats

ParameterTypeRequiredDefaultStabilityDescription
Some arguments may be required, as indicated in the Required column. For return datatypes, this indicates that you must specify which fields you want returned in the results.
Table last updated: Sep 11, 2025
currentStats(queryId: string): CurrentUsageQueryResultmultiple  Long-TermCurrent usage measurements and limits for ingest, storage, scanned data and users. See CurrentUsageQueryResult.
firstUsageTimeStamplongyes Long-TermThe date and time of first usage.
monthlyIngest(month: integer, year: integer, queryId: string): MonthlyIngestQueryResultmultipleyes Long-TermThe monthly amount of ingest. See MonthlyIngestQueryResult.
monthlyStoredData(month: integer, year: integer, queryId: string): MonthlyStorageQueryResultmultipleyes Long-TermThe monthly stored data. See MonthlyStorageQueryResult.
repositoriesIngest(month: integer, year: integer, day: integer, searchFilter: string, skip: integer, limit: integer, orderBy: OrderBy, sortBy: RepositoriesUsageQuerySortBy, queryId: string): RepositoriesUsageQueryResultTypesmultipleyes Long-TermThe ingest for the repositories. See OrderBy, and RepositoriesUsageQuerySortBy. See also RepositoriesUsageQueryResultTypes.
repositoriesStorage(month: integer, year: integer, day: integer, searchFilter: string, skip: integer, limit: integer, orderBy: OrderBy, sortBy: RepositoriesUsageQuerySortBy, queryId: string): RepositoriesUsageQueryResultTypesmultipleyes Long-TermThe storage for the repositories. See OrderBy, RepositoriesUsageQuerySortBy. and RepositoriesUsageQueryResultTypes,