> ## Documentation Index > Fetch the complete documentation index at: https://docs.mag3nt.com/llms.txt > Use this file to discover all available pages before exploring further. # Get your membership, tier, usage, plans, and auto-renew state > Native Token Rails membership tiers unlock DIRECT (project-token) settlement volume by calendar-month quota. Merchants always receive 100% of payment amounts; membership is an access fee, not a cut. Also returns everything needed to sign a USDC approve for wallet-pull auto-renew. ## OpenAPI ````yaml /openapi.yaml get /api/membership openapi: 3.1.0 info: title: mag3nt API version: '2026-07-16' description: > Payment infrastructure for AI agents. Issue virtual cards backed by credentials, pay for API access via x402/AP2/MPP protocols, and settle in USDC on Base. Also covers Native Token Rails membership and recurring billing agreements, ERC-20 project token registration (including B20) and prepaid MAG3NT fee metering for DIRECT (non-custodial) settlement, the credential marketplace and Credential Token (CT) markets, account-wide token holdings, and signed webhooks for payment and subscription lifecycle events. contact: name: mag3nt url: https://mag3nt.com license: name: Proprietary url: https://github.com/mag3nt-com/mag3nt-node/blob/main/LICENSE servers: - url: https://mag3nt.com description: Production - url: https://staging.mag3nt.com description: Staging, Base mainnet security: - ApiKeyAuth: [] tags: - name: Payments description: Universal outbound protocol payments - name: Cards description: Virtual payment card lifecycle - name: Keys description: Developer API key management - name: Funding description: Treasury deposits and balances - name: x402 description: HTTP 402 payment protocol - name: AP2 description: Agent-to-Agent Payment Protocol - name: MPP description: Micropayment Protocol with streaming - name: Pay Links description: Shareable payment URLs - name: Withdrawals description: Withdraw unspent funds back to wallet - name: Settlement description: On-chain settlement status - name: Webhooks description: Signed payment and subscription lifecycle notifications for sellers - name: Status description: System health and configuration - name: Membership description: Native Token Rails membership tiers, checkout, and auto-renew - name: Billing description: Recurring billing agreements funded by AP2 open mandates - name: Tokens description: >- Register an ERC-20 contract (including B20 tokens) for DIRECT credential settlement - name: Fees description: Prepaid MAG3NT fee meter for DIRECT settlement overage - name: Marketplace description: >- List and transfer credential businesses (proof of record) on the mag3nt marketplace - name: Credential Tokens description: Credential Token (CT) launch and Uniswap V4 markets - name: Holdings description: Account-wide Credential Token balances externalDocs: description: mag3nt documentation url: https://docs.mag3nt.com paths: /api/membership: get: tags: - Membership summary: Get your membership, tier, usage, plans, and auto-renew state description: > Native Token Rails membership tiers unlock DIRECT (project-token) settlement volume by calendar-month quota. Merchants always receive 100% of payment amounts; membership is an access fee, not a cut. Also returns everything needed to sign a USDC approve for wallet-pull auto-renew. operationId: membershipGet responses: '200': description: Membership snapshot content: application/json: schema: type: object properties: membership: oneOf: - $ref: '#/components/schemas/Membership' - type: 'null' active: type: boolean tier: type: string enum: - free - starter - growth - enterprise tiers: type: array items: $ref: '#/components/schemas/MembershipTier' usage: type: object properties: month: type: string example: 2026-07 direct_settles: type: integer quota: type: - integer - 'null' remaining: type: - integer - 'null' over_quota: type: boolean overage_fee_mag3nt: type: number plans: type: array items: $ref: '#/components/schemas/MembershipPlan' payments: type: array items: type: object properties: id: type: string plan: type: string interval: type: string enum: - month - year amount: type: number asset: type: string network: type: string tx_hash: type: string period_start: type: string format: date-time period_end: type: string format: date-time created_at: type: string format: date-time autopay: type: object description: >- Current auto-renew state. `enrolled` false when off; `soft` true for a legacy no-funds intent. properties: enrolled: type: boolean soft: type: boolean mode: type: - string - 'null' enum: - wallet - funded - soft - null agreement: oneOf: - $ref: '#/components/schemas/BillingAgreement' - type: 'null' next_charge_at: type: - string - 'null' format: date-time amount: type: - number - 'null' interval: type: string enum: - month - year plan_ref: type: string status: type: string wallet_autorenew: type: - object - 'null' description: >- Everything needed to sign a USDC approve for wallet-pull auto-renew. properties: operator: type: string price: type: number interval: type: string suggested_allowance: type: number description: >- Approve roughly a year of periods up front so the member signs once. token: type: object properties: address: type: string decimals: type: integer symbol: type: string network: type: string cdpNetwork: type: string treasury: type: string network: type: string tokens: type: object properties: USDC: type: - object - 'null' MAG3NT: type: object trial_days: type: integer '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Membership: type: object properties: wallet_address: type: string plan: type: string enum: - native_token_rails - starter - growth - enterprise description: native_token_rails is the legacy plan id, treated as starter. status: type: string enum: - ACTIVE - EXPIRED - CANCELLED - TRIAL current_period_start: type: string format: date-time current_period_end: type: string format: date-time cancel_at_period_end: type: boolean payment_asset: type: - string - 'null' last_payment_id: type: - string - 'null' auto_renew: type: boolean description: >- Soft renew intent. True when a funded or wallet-pull autopay agreement exists, or a legacy soft intent is set. created_at: type: string format: date-time updated_at: type: string format: date-time MembershipTier: type: object properties: id: type: string enum: - free - starter - growth - enterprise name: type: string description: type: string monthly_direct_quota: type: - integer - 'null' description: >- Settled DIRECT payments included per calendar month. null means unlimited (enterprise). self_serve: type: boolean description: >- Whether the tier is purchasable without operator assignment. Enterprise is always false. MembershipPlan: type: object properties: id: type: string enum: - starter - growth tier: type: string enum: - starter - growth name: type: string description: type: string interval: type: string enum: - month - year price_usdc: type: number price_mag3nt: type: number description: >- MAG3NT-denominated price. Self-serve checkout only accepts USDC today. period_days: type: integer monthly_direct_quota: type: - integer - 'null' BillingAgreement: type: object description: >- An AP2 open-mandate-backed recurring billing agreement. The open_mandate SD-JWT is never returned over the API. properties: id: type: string example: ba_9f8e7d6c... merchant_wallet: type: string description: >- 'mag3nt' for platform plans (membership, fee top-ups); otherwise the pay link owner's wallet. payer_wallet: type: string payer_card_id: type: string pay_link_code: type: - string - 'null' plan_ref: type: - string - 'null' description: >- Internal plan reference, e.g. "membership:starter:month". Mutually exclusive with pay_link_code. description: type: string amount: type: number asset: type: string network: type: string trigger_type: type: string enum: - interval - threshold period_days: type: - integer - 'null' threshold_metric: type: - string - 'null' example: mag3nt_fee_balance threshold_floor: type: - number - 'null' funding_source: type: string enum: - CARD - WALLET description: >- CARD debits a custodial reserve card. WALLET pulls from the member's own wallet via an on-chain allowance (transferFrom), used for membership wallet-pull auto-renew. funding_spender: type: - string - 'null' description: The approved on-chain operator (spender) address for WALLET funding. status: type: string enum: - ACTIVE - PAST_DUE - CANCELLED - COMPLETED - EXPIRED next_charge_at: type: - string - 'null' format: date-time last_charge_at: type: - string - 'null' format: date-time charges_made: type: integer total_charged: type: number failure_count: type: integer cancel_at_period_end: type: boolean created_at: type: string format: date-time updated_at: type: string format: date-time Error: type: object required: - error properties: error: type: string example: Card not found securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: API key prefixed with 'Bearer sx_live_...' ````