Skip to main content
Set up and manage your SEC API organization: authenticate clients, create API keys, inspect limits, and manage billing. Start with your current identity and effective limits, then create or list API keys for the current organization. For request authentication and account setup, read authentication and pricing.
The sidebar labels inside this family are the literal calls you make over HTTP. Descriptions stay in the body so the navigation stays sharp and scannable.

Operations in this family

GET /.well-known/oauth-authorization-server

Return or proxy OAuth authorization server metadata for the configured WorkOS tenant

GET /.well-known/oauth-protected-resource

Return OAuth protected resource metadata for hosted MCP and API clients

POST /mcp

Hosted MCP transport endpoint

GET /v1/api_keys

List API keys for the current organization

POST /v1/api_keys

Create a new API key for the current organization and reveal its secret exactly once

GET /v1/billing

Return the current organization’s billing snapshot, including pricing posture, budget controls, and settlement provider state

PUT /v1/billing/budget

Update organization-level spend caps, soft caps, and approval thresholds for PAYG usage

POST /v1/billing/checkout

Create a Stripe Checkout session for a self-serve Personal or Team SEC API plan

GET /v1/billing/credits

Return the current organization’s prepaid credit balance, auto-top-up settings, lifetime totals, and low-balance status

PUT /v1/billing/credits/auto-topup

Enable or disable automatic prepaid-credit top-ups and set the low-balance threshold and refill amount

POST /v1/billing/credits/refund

Refund the unspent credits of a prepaid top-up to the original payment method, within the refund window (platform fees non-refundable)

POST /v1/billing/credits/topup

Create a Stripe PaymentIntent to purchase prepaid credits, returning the client secret and the discount/fee charge breakdown

GET /v1/billing/credits/transactions

List the current organization’s prepaid credit ledger entries (top-ups, debits, refunds, grants, adjustments), newest first

POST /v1/billing/grant/reset

Re-grant the one-time free starter allowance (resets free-grant usage), rate-limited to once per rolling 30 days per organization

POST /v1/billing/payg/enable

Enable pay-as-you-go in one flow: save a card, make an initial credit top-up, and optionally turn on auto-top-up (returns a PaymentIntent client secret)

GET /v1/billing/payment-methods

List the current organization’s saved payment methods, primary first

PUT /v1/billing/payment-methods/{id}

Set a saved payment method as primary and/or change its auto-top-up fallback priority

DELETE /v1/billing/payment-methods/{id}

Remove a saved payment method from the current organization

POST /v1/billing/payment-methods/setup-intent

Create a Stripe SetupIntent to save a payment method off-session for top-ups and auto-top-up (max 3 per organization)

POST /v1/billing/portal

Create a Stripe Billing Portal session for the current organization

POST /v1/billing/quote

Quote a billable workflow or meter class against the current billing plan and budget gates

GET /v1/billing/rates

Return the public pricing catalog, starter grant metadata, plan metadata, and meter-family launch rates

GET /v1/billing/stripe-config

Return the current organization’s Stripe publishable-key configuration for browser payment setup

POST /v1/billing/webhooks/stripe

Receive and process signed Stripe subscription lifecycle webhooks

GET /v1/limits

Return the current organization’s effective plan, billing state, and route quota windows

GET /v1/me

Return the current authenticated principal and organization context

GET /v1/org

Return the current organization profile