Ardent V1 Billing API
The v1-billing API from Ardent — 3 operation(s) for v1-billing.
The v1-billing API from Ardent — 3 operation(s) for v1-billing.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/ardent:ardent-v1-billing-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fast V1 Billing API
version: 0.1.0
tags:
- name: v1-billing
paths:
/v1/orgs/{org_id}/billing/subscriptions:
post:
tags:
- v1-billing
summary: Create Subscription Endpoint
description: 'Create a self-serve subscription via Autumn (Stripe Checkout when needed).
Owner-only. Allowed plans are limited to SELF_SERVE_PLAN_IDS.'
operationId: create_subscription_endpoint_v1_orgs__org_id__billing_subscriptions_post
parameters:
- name: org_id
in: path
required: true
schema:
type: string
title: Org Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AttachRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/orgs/{org_id}/billing/subscription:
get:
tags:
- v1-billing
summary: Get Subscription Endpoint
description: Return current subscription status for the org.
operationId: get_subscription_endpoint_v1_orgs__org_id__billing_subscription_get
parameters:
- name: org_id
in: path
required: true
schema:
type: string
title: Org Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- v1-billing
summary: Delete Subscription Endpoint
description: 'Cancel the org''s subscription.
- immediate=false (default): cancel at period end
- immediate=true: cancel now'
operationId: delete_subscription_endpoint_v1_orgs__org_id__billing_subscription_delete
parameters:
- name: org_id
in: path
required: true
schema:
type: string
title: Org Id
- name: immediate
in: query
required: false
schema:
type: boolean
default: false
title: Immediate
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/orgs/{org_id}/billing/subscriptions:update:
post:
tags:
- v1-billing
summary: Update Subscription Endpoint
description: 'Update an org''s subscription: upgrade/downgrade or cancel.
- If `plan_id` is provided, changes the plan.
- If `cancel_now` is true, cancels immediately.
- If `cancel_at_period_end` is true, schedules cancel at period end.'
operationId: update_subscription_endpoint_v1_orgs__org_id__billing_subscriptions_update_post
parameters:
- name: org_id
in: path
required: true
schema:
type: string
title: Org Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateSubscriptionRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
UpdateSubscriptionRequest:
properties:
plan_id:
anyOf:
- type: string
- type: 'null'
title: Plan Id
cancel_at_period_end:
anyOf:
- type: boolean
- type: 'null'
title: Cancel At Period End
cancel_now:
anyOf:
- type: boolean
- type: 'null'
title: Cancel Now
type: object
title: UpdateSubscriptionRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
AttachRequest:
properties:
plan_id:
type: string
title: Plan Id
success_url:
anyOf:
- type: string
- type: 'null'
title: Success Url
type: object
required:
- plan_id
title: AttachRequest
x-provenance:
method: harvested
publisher: Ardent
source: https://api.tryardent.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)