Get a customer's agent billing policy
One billing scope: the customer’s default policy, or one agent’s own when agent is passed. 404 when that scope has no policy of its own.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
Agent scope identifier. Null on scoped results denotes the customer's shared pool.
1 - 128"support"
Response
Unique Hyperline identifier for this resource.
"d18603dd-7285-4bf5-a45e-88d7de8f37c9"
Hyperline customer identifier.
"cus_example"
Agent scope identifier. Null is the customer's shared pool.
"support"
Whether this is the default plan or shared customer scope.
false
Billing mode.
- wallet: Charges a monetary wallet.
- credits: Consumes a credit balance.
- windows: Meters weighted units against rolling allowances.
wallet, credits, windows "wallet"
Customer wallet identifier. Omit on wallet policy writes to provision or reuse the customer's wallet.
"wal_example"
Public credit product identifier whose balance this policy consumes.
"prd_credits"
Percentage added to resolved cost. Null on writes means no override; an attached plan may supply the value.
^-?\d+(\.\d+)?(e[+-]?\d+)?$/i"20"
Behavior when credits or an allowance are exhausted. Policy values may inherit the attached plan.
- refuse: Rejects the call that crosses the boundary without deducting usage.
- metered: Prices the whole call as monetary overage, using the overage card or USD provider cost plus markup.
refuse, metered "metered"
Percentage added to provider cost for overage. Mutually exclusive with overage_rate_card_id.
^-?\d+(\.\d+)?(e[+-]?\d+)?$/i"10"
Currency rate card used to price overage directly. Null means provider cost plus the resolved overage markup.
"airc_overage"
Source of the effective overage rate card. Null when no card is configured.
- policy: Selected directly on the customer policy.
- plan: Inherited from the attached plan.
policy, plan "plan"
Wallet charged for overage. Null bills overage in arrears.
"wal_example"
Minimum available balance a spend check requires, in the policy's denomination.
^-?\d+(\.\d+)?(e[+-]?\d+)?$/i"0"
Inline credit pricing. Mutually exclusive with rate_card_id. Omitted rates may be supplied by a plan or product default.
Window definitions and optional inline unit rates. An attached plan may supply omitted definitions; rate_card_id may supply unit rates.
Rate card reference. On policy writes, omission preserves the current reference and null detaches it; on plan replacement omission clears it.
"airc_example"
Source of the effective rate card. Null when no card is configured.
- policy: Selected directly on the customer policy.
- plan: Inherited from the attached plan.
policy, plan "policy"
Attached plan summary, or null.
Settlement interval in minutes. Null means no interval override. Mutually exclusive with settlement_schedule.
60
Calendar settlement schedule. Null clears the override; mutually exclusive with settlement_interval_minutes.
- calendar_month: Settles at the end of each UTC calendar month.
calendar_month "calendar_month"
Summary of the effective pricing after applying rate-card inheritance. Null when no card resolves.
Whether spending is disabled for this billing scope.
false
Creation time as a UTC ISO 8601 timestamp.
"2026-09-01T00:00:00Z"
Last update time as a UTC ISO 8601 timestamp.
"2026-09-02T12:00:00Z"

