orb-billing
Version:
The official TypeScript library for the Orb API
211 lines • 7.04 kB
TypeScript
import { APIResource } from "../../resource.js";
import * as Core from "../../core.js";
import * as Shared from "../shared.js";
export declare class Usage extends APIResource {
/**
* Returns usage and remaining credits for all licenses of a given type on a
* subscription.
*
* Date range defaults to the current billing period if not specified.
*/
getAllUsage(query: UsageGetAllUsageParams, options?: Core.RequestOptions): Core.APIPromise<UsageGetAllUsageResponse>;
/**
* Returns usage and remaining credits for a specific license over a date range.
*
* Date range defaults to the current billing period if not specified.
*/
getUsage(licenseId: string, query?: UsageGetUsageParams, options?: Core.RequestOptions): Core.APIPromise<UsageGetUsageResponse>;
getUsage(licenseId: string, options?: Core.RequestOptions): Core.APIPromise<UsageGetUsageResponse>;
}
export interface UsageGetAllUsageResponse {
data: Array<UsageGetAllUsageResponse.Data>;
pagination_metadata: Shared.PaginationMetadata;
}
export declare namespace UsageGetAllUsageResponse {
/**
* The LicenseUsage resource represents usage and remaining credits for a license
* over a date range.
*
* When grouped by 'day' only, license_id and external_license_id will be null as
* the data is aggregated across all licenses.
*/
interface Data {
/**
* The total credits allocated to this license for the period.
*/
allocated_credits: number;
/**
* The credits consumed by this license for the period.
*/
consumed_credits: number;
/**
* The end date of the usage period.
*/
end_date: string;
/**
* The unique identifier for the license type.
*/
license_type_id: string;
/**
* The pricing unit for the credits (e.g., 'credits').
*/
pricing_unit: string;
/**
* The remaining credits available for this license (allocated - consumed).
*/
remaining_credits: number;
/**
* The start date of the usage period.
*/
start_date: string;
/**
* The unique identifier for the subscription.
*/
subscription_id: string;
/**
* Credits consumed while the license was active (eligible for individual
* allocation deduction).
*/
allocation_eligible_credits?: number | null;
/**
* The external identifier for the license. Null when grouped by day only.
*/
external_license_id?: string | null;
/**
* The unique identifier for the license. Null when grouped by day only.
*/
license_id?: string | null;
/**
* Credits consumed while the license was inactive (draws from shared pool, not
* individual allocation).
*/
shared_pool_credits?: number | null;
}
}
export interface UsageGetUsageResponse {
data: Array<UsageGetUsageResponse.Data>;
pagination_metadata: Shared.PaginationMetadata;
}
export declare namespace UsageGetUsageResponse {
/**
* The LicenseUsage resource represents usage and remaining credits for a license
* over a date range.
*
* When grouped by 'day' only, license_id and external_license_id will be null as
* the data is aggregated across all licenses.
*/
interface Data {
/**
* The total credits allocated to this license for the period.
*/
allocated_credits: number;
/**
* The credits consumed by this license for the period.
*/
consumed_credits: number;
/**
* The end date of the usage period.
*/
end_date: string;
/**
* The unique identifier for the license type.
*/
license_type_id: string;
/**
* The pricing unit for the credits (e.g., 'credits').
*/
pricing_unit: string;
/**
* The remaining credits available for this license (allocated - consumed).
*/
remaining_credits: number;
/**
* The start date of the usage period.
*/
start_date: string;
/**
* The unique identifier for the subscription.
*/
subscription_id: string;
/**
* Credits consumed while the license was active (eligible for individual
* allocation deduction).
*/
allocation_eligible_credits?: number | null;
/**
* The external identifier for the license. Null when grouped by day only.
*/
external_license_id?: string | null;
/**
* The unique identifier for the license. Null when grouped by day only.
*/
license_id?: string | null;
/**
* Credits consumed while the license was inactive (draws from shared pool, not
* individual allocation).
*/
shared_pool_credits?: number | null;
}
}
export interface UsageGetAllUsageParams {
/**
* The license type ID to filter licenses by.
*/
license_type_id: string;
/**
* The subscription ID to get license usage for.
*/
subscription_id: string;
/**
* Pagination cursor from a previous request.
*/
cursor?: string | null;
/**
* End date for the usage period (YYYY-MM-DD). Defaults to end of current billing
* period.
*/
end_date?: string | null;
/**
* How to group the results. Valid values: 'license', 'day'. Can be combined (e.g.,
* 'license,day').
*/
group_by?: Array<string> | null;
/**
* Maximum number of rows in the response data (default 20, max 100).
*/
limit?: number;
/**
* Start date for the usage period (YYYY-MM-DD). Defaults to start of current
* billing period.
*/
start_date?: string | null;
}
export interface UsageGetUsageParams {
/**
* Pagination cursor from a previous request.
*/
cursor?: string | null;
/**
* End date for the usage period (YYYY-MM-DD). Defaults to end of current billing
* period.
*/
end_date?: string | null;
/**
* How to group the results. Valid values: 'license', 'day'. Can be combined (e.g.,
* 'license,day').
*/
group_by?: Array<string> | null;
/**
* Maximum number of rows in the response data (default 20, max 100).
*/
limit?: number;
/**
* Start date for the usage period (YYYY-MM-DD). Defaults to start of current
* billing period.
*/
start_date?: string | null;
}
export declare namespace Usage {
export { type UsageGetAllUsageResponse as UsageGetAllUsageResponse, type UsageGetUsageResponse as UsageGetUsageResponse, type UsageGetAllUsageParams as UsageGetAllUsageParams, type UsageGetUsageParams as UsageGetUsageParams, };
}
//# sourceMappingURL=usage.d.ts.map