> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform

> Set up and manage your SEC API organization: authenticate clients, create API keys, inspect limits, and manage billing.

Set up and manage your SEC API organization: authenticate clients, create API keys, inspect limits, and manage billing.

Start with [your current identity](/api-reference/platform/get-v1-me) and [effective limits](/api-reference/platform/get-v1-limits), then create or list API keys for the current organization. For request authentication and account setup, read [authentication and pricing](/auth-and-pricing).

<Note>
  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.
</Note>

## Operations in this family

<CardGroup cols={2}>
  <Card title="GET /.well-known/oauth-authorization-server" href="/api-reference/platform/get--well-known-oauth-authorization-server">Return or proxy OAuth authorization server metadata for the configured WorkOS tenant</Card>
  <Card title="GET /.well-known/oauth-protected-resource" href="/api-reference/platform/get--well-known-oauth-protected-resource">Return OAuth protected resource metadata for hosted MCP and API clients</Card>
  <Card title="POST /mcp" href="/api-reference/platform/post-mcp">Hosted MCP transport endpoint</Card>
  <Card title="GET /v1/api_keys" href="/api-reference/platform/get-v1-api-keys">List API keys for the current organization</Card>
  <Card title="POST /v1/api_keys" href="/api-reference/platform/post-v1-api-keys">Create a new API key for the current organization and reveal its secret exactly once</Card>
  <Card title="GET /v1/billing" href="/api-reference/platform/get-v1-billing">Return the current organization's billing snapshot, including pricing posture, budget controls, and settlement provider state</Card>
  <Card title="PUT /v1/billing/budget" href="/api-reference/platform/put-v1-billing-budget">Update organization-level spend caps, soft caps, and approval thresholds for PAYG usage</Card>
  <Card title="POST /v1/billing/checkout" href="/api-reference/platform/post-v1-billing-checkout">Create a Stripe Checkout session for a self-serve Personal or Team SEC API plan</Card>
  <Card title="GET /v1/billing/credits" href="/api-reference/platform/get-v1-billing-credits">Return the current organization's prepaid credit balance, auto-top-up settings, lifetime totals, and low-balance status</Card>
  <Card title="PUT /v1/billing/credits/auto-topup" href="/api-reference/platform/put-v1-billing-credits-auto-topup">Enable or disable automatic prepaid-credit top-ups and set the low-balance threshold and refill amount</Card>
  <Card title="POST /v1/billing/credits/refund" href="/api-reference/platform/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)</Card>
  <Card title="POST /v1/billing/credits/topup" href="/api-reference/platform/post-v1-billing-credits-topup">Create a Stripe PaymentIntent to purchase prepaid credits, returning the client secret and the discount/fee charge breakdown</Card>
  <Card title="GET /v1/billing/credits/transactions" href="/api-reference/platform/get-v1-billing-credits-transactions">List the current organization's prepaid credit ledger entries (top-ups, debits, refunds, grants, adjustments), newest first</Card>
  <Card title="POST /v1/billing/grant/reset" href="/api-reference/platform/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</Card>
  <Card title="POST /v1/billing/payg/enable" href="/api-reference/platform/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)</Card>
  <Card title="GET /v1/billing/payment-methods" href="/api-reference/platform/get-v1-billing-payment-methods">List the current organization's saved payment methods, primary first</Card>
  <Card title="PUT /v1/billing/payment-methods/{id}" href="/api-reference/platform/put-v1-billing-payment-methods-id">Set a saved payment method as primary and/or change its auto-top-up fallback priority</Card>
  <Card title="DELETE /v1/billing/payment-methods/{id}" href="/api-reference/platform/delete-v1-billing-payment-methods-id">Remove a saved payment method from the current organization</Card>
  <Card title="POST /v1/billing/payment-methods/setup-intent" href="/api-reference/platform/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)</Card>
  <Card title="POST /v1/billing/portal" href="/api-reference/platform/post-v1-billing-portal">Create a Stripe Billing Portal session for the current organization</Card>
  <Card title="POST /v1/billing/quote" href="/api-reference/platform/post-v1-billing-quote">Quote a billable workflow or meter class against the current billing plan and budget gates</Card>
  <Card title="GET /v1/billing/rates" href="/api-reference/platform/get-v1-billing-rates">Return the public pricing catalog, starter grant metadata, plan metadata, and meter-family launch rates</Card>
  <Card title="GET /v1/billing/stripe-config" href="/api-reference/platform/get-v1-billing-stripe-config">Return the current organization's Stripe publishable-key configuration for browser payment setup</Card>
  <Card title="POST /v1/billing/webhooks/stripe" href="/api-reference/platform/post-v1-billing-webhooks-stripe">Receive and process signed Stripe subscription lifecycle webhooks</Card>
  <Card title="GET /v1/limits" href="/api-reference/platform/get-v1-limits">Return the current organization's effective plan, billing state, and route quota windows</Card>
  <Card title="GET /v1/me" href="/api-reference/platform/get-v1-me">Return the current authenticated principal and organization context</Card>
  <Card title="GET /v1/org" href="/api-reference/platform/get-v1-org">Return the current organization profile</Card>
</CardGroup>
