Struct UsageApiResponse 

#[non_exhaustive]
pub struct UsageApiResponse {
    pub five_hour: Option<UsageBucket>,
    pub seven_day: Option<UsageBucket>,
    pub seven_day_opus: Option<UsageBucket>,
    pub seven_day_sonnet: Option<UsageBucket>,
    pub seven_day_oauth_apps: Option<UsageBucket>,
    pub extra_usage: Option<ExtraUsage>,
    pub unknown_buckets: HashMap<String, Value>,
}

Shape of the OAuth /api/oauth/usage endpoint response. Every recognized bucket is Option because the endpoint omits (or emits null for) buckets that don’t apply to the account’s tier, and unknown_buckets captures codenamed / unreleased buckets Anthropic may add without notice (omelette_*, iguana_*, cowork, etc. observed live 2026-04-18). See docs/research/claude-data-files.md §Raw data for the reference capture.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

five_hour: Option<UsageBucket>

seven_day: Option<UsageBucket>

seven_day_opus: Option<UsageBucket>

seven_day_sonnet: Option<UsageBucket>

seven_day_oauth_apps: Option<UsageBucket>

extra_usage: Option<ExtraUsage>

unknown_buckets: HashMap<String, Value>

Forward-compat catch-all. Any top-level key not matched above lands here as raw JSON so we preserve what the endpoint sent even when we don’t yet know what to do with it.

Implementations

impl UsageApiResponse

pub fn into_endpoint_usage(self) -> EndpointUsage

Convert the wire shape into the internal EndpointUsage. Unknown buckets are preserved so plugin-facing mirrors can surface them; the wire UsageApiResponse is not retained.

Trait Implementations

impl Clone for UsageApiResponse

fn clone(&self) -> UsageApiResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UsageApiResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageApiResponse

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<CachedData> for UsageApiResponse

fn from(c: CachedData) -> Self

Converts to this type from the input type.

impl From<UsageApiResponse> for CachedData

fn from(r: UsageApiResponse) -> Self

Converts to this type from the input type.

impl PartialEq for UsageApiResponse

fn eq(&self, other: &UsageApiResponse) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for UsageApiResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UsageApiResponse