Kinetic Pricing

Showing 25 of 100 from the live probe.

• Get the authorized account's profile.

  Get the authorized account's profile. Returns the account behind the current grant: id, email, and creation time. Mirrors what the account holder sees on the website. Auth: OAuth bearer with scope kinetic.account.read. REST equivalent: GET https://api.kineticpricing.com/v1/account.

• List the account's Kinetic API access tokens.

  List the account's Kinetic API access tokens. Returns the acting user's static API access tokens: id, name, the public token prefix (kp_live_<public_id> — never the secret half), granted scopes, status (active/revoked/expired), and created/expires/last-used/rotated times. Secrets and secret hashes are never returned by any endpoint. Personal credentials: a service-account token is forbidden here. Auth: OAuth bearer with scope kinetic.integrations.read. REST equivalent: GET https://api.kineticpri

• Create a Kinetic API access token (one-time secret).

  Create a Kinetic API access token (one-time secret). Mints a static bearer token (kp_live_…) that delegates the acting user's live authority, restricted to the requested scopes. The full token is returned EXACTLY ONCE in `token` — store it immediately; it is never retrievable again. Scopes must be a subset of what the caller itself holds AND within the acting user's current workspace-role authority (viewers grant read scopes; editors add workspace writes; owners grant any scope); ["kinetic.full"

• Rotate an API access token's secret (one-time secret).

  Rotate an API access token's secret (one-time secret). Issues a brand-new token string (new public id and secret) for this token and invalidates the previous credential in the same atomic update — the old string stops working immediately. Name, scopes, and expiry are unchanged. The new token is returned EXACTLY ONCE in `token`. A missing, foreign, or revoked token reads as resource_not_found. Requires recent human authorization (10 minutes), same as token creation: OAuth callers need a freshly a

• Revoke (disable) an API access token.

  Revoke (disable) an API access token. Disables the token so it can never authenticate again, effective immediately on the next request. Idempotent: revoking an already-revoked token still succeeds. A missing or foreign token reads as resource_not_found — list tokens first with kinetic.api_token_list to obtain a valid id. Auth: OAuth bearer with scope kinetic.integrations.write. idempotency_key is optional but recommended for safe retries. REST equivalent: DELETE https://api.kineticpricing.com/v1

• List purchasable offers: one-time study prices and Kinetic Pro plans.

  List purchasable offers: one-time study prices and Kinetic Pro plans. The complete, server-owned pricing surface. `study_methods` are the enabled one-time research methods with launch prices in integer cents and their methodology versions. `pro_subscription` is the Kinetic Pro subscription offer: monthly and annual prices in cents, the annual monthly-equivalent and annual savings, the seat limit, whether Pro/Workspace/scenarios are enabled, and whether checkout is currently available (with a rea

• Get the account's Kinetic Pro entitlement state.

  Get the account's Kinetic Pro entitlement state. Returns whether the authorized account (or, for a service account, the workspace owner it acts as) currently has Kinetic Pro: the entitlement `state`, whether it is `active`, whether the Workspace is `read_only` (had Pro, lost it), renewal/cancel and grace details, plus the pro/workspace/scenarios feature flags. Read-only. Auth: OAuth bearer with scope kinetic.billing.read. REST equivalent: GET https://api.kineticpricing.com/v1/billing/entitlement

• Get the account's Kinetic Pro subscription status.

  Get the account's Kinetic Pro subscription status. Mirrors the website subscription panel: entitlement `state`, `active`, `read_only`, `cancel_at_period_end`, billing `interval`, `current_period_end`, `workspace_id`, and the acting user's `role`. Read-only. Use before cancel/resume to decide whether a change is needed. Auth: OAuth bearer with scope kinetic.billing.read. REST equivalent: GET https://api.kineticpricing.com/v1/billing/subscription.

• Preview the one-use upgrade credit toward Kinetic Pro.

  Preview the one-use upgrade credit toward Kinetic Pro. Computes the upgrade credit the account has earned from recent net one-time study purchases inside the trailing window: `eligible_cents`, the amount that would apply to a monthly (`applied_monthly_cents`) or annual (`applied_annual_cents`) plan, the `window_days`, the `source_study_count`, and a `reason` (`ok`, `no_recent_purchases`, or `already_redeemed`, since the credit is one-use-ever). Read-only; the credit is only actually reserved whe

• Start a Stripe checkout to pay for a draft study.

  Start a Stripe checkout to pay for a draft study. Creates (or reuses a still-open) Stripe Checkout session for a one-time study purchase and returns `{checkout_url, study_id, amount_cents, expires_at?}` — the account holder completes payment on Stripe's hosted page in a browser. Card details never travel through this API: never collect or relay them. Over MCP the handoff arrives as a URL elicitation when your client supports it, otherwise as a structured body with `requires_user_action: true` an

• Start a Stripe checkout to subscribe to Kinetic Pro.

  Start a Stripe checkout to subscribe to Kinetic Pro. Creates (or reuses a still-open) Stripe subscription Checkout session for Kinetic Pro and returns `{checkout_url, interval, credit_applied_cents, expires_at?}` — the workspace owner completes payment on Stripe's hosted page in a browser. Card details never travel through this API: never collect or relay them. Over MCP the handoff arrives as a URL elicitation when your client supports it, otherwise as a structured body with `requires_user_actio

• Schedule the Kinetic Pro subscription to cancel at period end.

  Schedule the Kinetic Pro subscription to cancel at period end. Turns on cancel-at-period-end: Kinetic Pro keeps running until the current period ends, then does not renew. Owner-only. Returns the resulting subscription status (same shape as get subscription). Idempotent: if cancellation is already scheduled, the current state is returned unchanged (not an error). With no active/canceling subscription it fails with resource_not_found. Repeat-safe; an Idempotency-Key is honored when provided. Auth

• Undo a scheduled Kinetic Pro cancellation before it takes effect.

  Undo a scheduled Kinetic Pro cancellation before it takes effect. Clears cancel-at-period-end so the subscription renews normally again. Owner-only. Returns the resulting subscription status (same shape as get subscription). Idempotent: if the subscription is not scheduled to cancel, the current state is returned unchanged (not an error). With no active subscription it fails with resource_not_found. Repeat-safe; an Idempotency-Key is honored when provided. Auth: OAuth bearer with scope kinetic.b

• List available research methods with server-owned pricing.

  List available research methods with server-owned pricing. The catalogue of study methods (Van Westendorp, Gabor-Granger, MaxDiff, choice-based conjoint) that are currently enabled, with launch prices in cents, methodology versions, and sample-size guidance. Public: no authentication required. Auth: none required. REST equivalent: GET https://api.kineticpricing.com/v1/methods.

• Recommend a research method for a pricing decision.

  Recommend a research method for a pricing decision. Deterministic rules mapping the pricing decision you face to the best-fit method, with the reasoning and when to prefer an alternative. Decisions: price_range (what range will buyers accept), exact_price (which exact price to charge), feature_priorities (which features matter most), package_pricing (how to package features and price the bundle). Auth: none required. REST equivalent: POST https://api.kineticpricing.com/v1/methods/recommendation.

• Orient yourself: what Kinetic Pricing offers and how to proceed.

  Orient yourself: what Kinetic Pricing offers and how to proceed. Returns what this service does, how authentication works (OAuth consent for existing accounts, agent-assisted signup for new ones), and the full capability catalogue grouped by area with the scope each one needs. Call this first. Auth: none required. REST equivalent: GET https://api.kineticpricing.com/v1.

• List the account's OAuth grants (authorized clients).

  List the account's OAuth grants (authorized clients). Returns the active OAuth grants for the authorized account: which clients hold access, the client display name (from client metadata when available), the granted scopes, resource audiences, and created/updated/last-used times. Use a grant id with kinetic.grant_revoke to withdraw access. Auth: OAuth bearer with scope kinetic.integrations.read. REST equivalent: GET https://api.kineticpricing.com/v1/integrations/grants.

• Revoke an OAuth grant and its refresh tokens.

  Revoke an OAuth grant and its refresh tokens. Withdraws a client's access: the grant is marked revoked and every refresh token derived from it is revoked immediately. Already-issued access tokens are short-lived and expire naturally rather than being invalidated here. Revoking an already-revoked grant succeeds idempotently. If the grant does not exist or belongs to another account you get resource_not_found — list grants first with kinetic.grant_list to obtain a valid id. Auth: OAuth bearer with

• List the workspace's service accounts.

  List the workspace's service accounts. Returns the machine credentials (service accounts) belonging to the caller's Kinetic Workspace: id, name, client_id, granted scopes, status (active/revoked/expired), and created/last-used/rotated times. Secrets and secret hashes are never returned. Requires an active Kinetic Pro workspace. Auth: OAuth bearer with scope kinetic.integrations.read. REST equivalent: GET https://api.kineticpricing.com/v1/integrations/service-accounts.

• Create a workspace service account (client credentials).

  Create a workspace service account (client credentials). Provisions a machine credential for the caller's Kinetic Workspace and returns a client_id and a one-time client_secret usable at the OAuth token endpoint (client_credentials grant). The secret is shown EXACTLY ONCE — store it immediately, it cannot be retrieved later. Scopes must be a subset of the account-holder scopes an owner can grant (kinetic.full is not accepted; list explicit scopes). Owner-only: only the workspace owner via a USER

• Rotate a service account's secret.

  Rotate a service account's secret. Issues a new client_secret for the service account and immediately invalidates the previous one. The new secret is returned EXACTLY ONCE — store it now, it cannot be retrieved later. Owner-only via a USER token; a service-account token is forbidden. If the account does not exist, is revoked, or belongs to another workspace you get resource_not_found. Requires an active Kinetic Pro workspace. Auth: OAuth bearer with scope kinetic.integrations.write. idempotency_

• Revoke (disable) a service account.

  Revoke (disable) a service account. Disables the service account so it can never authenticate again. Idempotent: revoking an already-revoked account still succeeds. Owner-only via a USER token; a service-account token is forbidden. If the account does not exist or belongs to another workspace you get resource_not_found. Requires an active Kinetic Pro workspace. Auth: OAuth bearer with scope kinetic.integrations.write. idempotency_key is optional but recommended for safe retries. REST equivalent:

• Start agent-assisted signup for a new Kinetic Pricing account.

  Start agent-assisted signup for a new Kinetic Pricing account. Creates a signup attempt and emails the account holder a confirmation link. Returns an attempt token (shown exactly once — store it). The account is only created after the holder clicks the link AND you call complete with terms_accepted=true. Never claim the account exists before completion succeeds. Enumeration-safe: the response never reveals whether the email already has an account. Auth: none required. REST equivalent: POST https

• Check whether the account holder confirmed a signup attempt.

  Check whether the account holder confirmed a signup attempt. Requires the attempt token from kinetic.signup_start (as the bearer on REST, or as attempt_token here). A wrong token reads as not found. States: pending_verification → verified → completed (or expired). Auth: the signup attempt token (pass it as attempt_token). REST equivalent: GET https://api.kineticpricing.com/v1/signup-attempts/{id}.

• Complete a verified signup attempt (explicit terms acceptance).

  Complete a verified signup attempt (explicit terms acceptance). Only works after the account holder clicked the emailed confirmation link (state=verified). You MUST pass terms_accepted=true — this records the account holder's acceptance of the terms version returned by kinetic.signup_start. Never call this without the holder's actual consent. Idempotent: repeating it returns the same completed state. Auth: the signup attempt token (pass it as attempt_token). REST equivalent: POST https://api.kin