Tiers

Get wallet tier status

Returns the wallet's current tier, lease expiry, and resource pool usage. Requires wallet auth.

get/tiers/v1/status

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/tiers/v1/status
  • Auth: API key in header SIGN-IN-WITH-X

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Response

Wallet tier status

walletstring required

Lowercased wallet address.

tier'prototype' | 'hobby' | 'team' | 'null' nullable required

Current tier, or null if the wallet has never set one.

lease_started_atstring date-time nullable required

ISO-8601 timestamp when the current lease began. Null if no tier.

lease_expires_atstring date-time nullable required

ISO-8601 timestamp when the current lease expires. Null if no tier.

activeboolean required

True when a tier is set and the lease is perpetual or its effective expiry is in the future. Perpetual effective expiry is null.

organization_lifecycle_state'active' | 'past_due' | 'frozen' | 'dormant' | 'purged' | 'null' nullable required

Lifecycle state of the owning organization. Null only for orphan wallets with no organization row.

lease_perpetualboolean nullable required

Operator escape hatch flag on the owning organization. When true, the organization never advances past 'active' regardless of lease expiry. Null only for orphan wallets.

lease'perpetual' | 'leased' | 'null' nullable required

kygit-handoff D4 — 'perpetual' for a lease-less tier (prototype: one x402 payment, never expires, never scheduler-advanced), 'leased' for hobby/team. Null only when tier is null.

lease_daysinteger nullable required

kygit-handoff D4 — days remaining on a LEASED tier (ceil, floored at 0), or null for a perpetual tier or no tier.

downgraded_atstring date-time nullable required

kygit-handoff D4 — ISO-8601 timestamp of the organization's most recent lifecycle-ladder downgrade to perpetual prototype (the ladder's terminal transition; nothing is deleted, hobby/team capacity is restored on renewal). Null if the organization has never been downgraded.

platform_status'degraded'

Health-assessment rider. Present and equal to degraded only while an open platform incident is global or affects one of this caller's projects; omitted when clear. Read the project events feed (platform_incident entries + the platform_incidents[] overlay) for the incident detail. The same rider appears on GET /agent/v1/me/status and the events-feed envelope, and nowhere else.

Example response

{
  "pool_usage": {
    "total_storage": "12.3 MB",
    "vault_source": "0 B",
    "storage_bytes_limit": 250000000,
    "storage_limit": "250 MB",
    "source_bytes_limit": 1000000000,
    "source_limit": "1 GB"
  },
  "projects": [
    {
      "project_id": "prj_1741340000_0042"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.