CoraPilot Billing API

The billing API from CoraPilot — 12 operation(s) for billing.

GitHub OpenAPI

Operations 12

0 of 12 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 1 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file

GET /billing/config Billing Config observed #
GET /billing/services List Services #
POST /billing/services/subscribe Subscribe Service #
GET /billing/referral Referral Info #
POST /billing/referral/invite Referral Invite #
POST /billing/checkout-session Checkout Session #
POST /billing/subscribe Subscribe #
GET /billing/status Subscription Status #
POST /billing/usage Add Usage Record #
GET /billing/usage-summary Usage Summary #
POST /billing/webhook Stripe Webhook #
GET /billing/usage-breakdown Usage Breakdown #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/corapilot-com:corapilot-com-billing-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

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 Specification

corapilot-com-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Corapilot Com Billing API
  version: 0.1.0
  description: 'Operations tagged billing across 2 of this provider''s published API definitions: corapilot-com-openapi.json, corapilot-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://corapilot.com
  description: Host serving this spec (/openapi.json), its Swagger UI (/docs) and the OAuth-protected MCP resource (https://corapilot.com/mcp per /.well-known/oauth-protected-resource); the published spec carries no servers[].
tags:
- name: Billing
paths:
  /billing/config:
    get:
      tags:
      - Billing
      summary: Billing Config
      description: Public billing config for the frontend (publishable key is safe to expose).
      operationId: billing_config_billing_config_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Billing Config Billing Config Get
  /billing/services:
    get:
      tags:
      - Billing
      summary: List Services
      description: Pricing for the available services + this customer's service subscriptions.
      operationId: list_services_billing_services_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Services Billing Services Get
      security:
      - HTTPBearer: []
  /billing/services/subscribe:
    post:
      tags:
      - Billing
      summary: Subscribe Service
      description: 'Start a Google Ads service subscription — either a free trial or a paid

        subscription (which can be purchased multiple times, one per Google Ads account).'
      operationId: subscribe_service_billing_services_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ServiceSubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutSessionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/referral:
    get:
      tags:
      - Billing
      summary: Referral Info
      description: Return the customer's referral code, share link and reward counts.
      operationId: referral_info_billing_referral_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Referral Info Billing Referral Get
      security:
      - HTTPBearer: []
  /billing/referral/invite:
    post:
      tags:
      - Billing
      summary: Referral Invite
      description: Email a friend the customer's referral link.
      operationId: referral_invite_billing_referral_invite_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReferralInviteRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Referral Invite Billing Referral Invite Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/checkout-session:
    post:
      tags:
      - Billing
      summary: Checkout Session
      operationId: checkout_session_billing_checkout_session_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckoutSessionRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutSessionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/subscribe:
    post:
      tags:
      - Billing
      summary: Subscribe
      description: Start a Stripe Checkout for the flat monthly/yearly subscription.
      operationId: subscribe_billing_subscribe_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubscribeRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutSessionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/status:
    get:
      tags:
      - Billing
      summary: Subscription Status
      description: Trial/subscription status for the account (days left, whether they must subscribe).
      operationId: subscription_status_billing_status_get
      security:
      - HTTPBearer: []
      parameters:
      - name: account_id
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionStatusOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /billing/usage:
    post:
      tags:
      - Billing
      summary: Add Usage Record
      operationId: add_usage_record_billing_usage_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UsageRecordRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Add Usage Record Billing Usage Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /billing/usage-summary:
    get:
      tags:
      - Billing
      summary: Usage Summary
      operationId: usage_summary_billing_usage_summary_get
      security:
      - HTTPBearer: []
      parameters:
      - name: account_id
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageSummary'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /billing/webhook:
    post:
      tags:
      - Billing
      summary: Stripe Webhook
      operationId: stripe_webhook_billing_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Stripe Webhook Billing Webhook Post
  /billing/usage-breakdown:
    get:
      tags:
      - Billing
      summary: Usage Breakdown
      description: Get detailed usage breakdown by source and date.
      operationId: usage_breakdown_billing_usage_breakdown_get
      security:
      - HTTPBearer: []
      parameters:
      - name: days
        in: query
        required: false
        schema:
          type: integer
          default: 30
          title: Days
      - name: account_id
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: 'null'
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Usage Breakdown Billing Usage Breakdown Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SubscribeRequest:
      properties:
        account_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Account Id
        interval:
          type: string
          title: Interval
          default: year
        success_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Success Url
        cancel_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Cancel Url
      type: object
      title: SubscribeRequest
    ServiceSubscribeRequest:
      properties:
        product:
          type: string
          title: Product
          default: google_ads
        interval:
          type: string
          title: Interval
          default: month
        label:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
        trial:
          type: boolean
          title: Trial
          default: false
        customer_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Customer Id
      type: object
      title: ServiceSubscribeRequest
    ReferralInviteRequest:
      properties:
        email:
          type: string
          format: email
          title: Email
      type: object
      required:
      - email
      title: ReferralInviteRequest
    UsageRecordRequest:
      properties:
        account_id:
          type: integer
          title: Account Id
        units:
          type: number
          exclusiveMinimum: 0.0
          title: Units
        unit_type:
          type: string
          maxLength: 50
          minLength: 2
          title: Unit Type
          default: compute_minute
        source:
          type: string
          maxLength: 100
          minLength: 2
          title: Source
          default: assistant_execution
      type: object
      required:
      - account_id
      - units
      title: UsageRecordRequest
    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
    CheckoutSessionResponse:
      properties:
        checkout_url:
          type: string
          title: Checkout Url
        mode:
          type: string
          title: Mode
        using_mock:
          type: boolean
          title: Using Mock
          default: false
      type: object
      required:
      - checkout_url
      - mode
      title: CheckoutSessionResponse
    UsageSummary:
      properties:
        account_id:
          type: integer
          title: Account Id
        current_cycle_units:
          type: number
          title: Current Cycle Units
        usage_cost_cents:
          type: integer
          title: Usage Cost Cents
        fixed_monthly_cents:
          type: integer
          title: Fixed Monthly Cents
        projected_total_cents:
          type: integer
          title: Projected Total Cents
      type: object
      required:
      - account_id
      - current_cycle_units
      - usage_cost_cents
      - fixed_monthly_cents
      - projected_total_cents
      title: UsageSummary
    CheckoutSessionRequest:
      properties:
        account_id:
          type: integer
          title: Account Id
        success_url:
          type: string
          title: Success Url
          default: https://example.com/billing/success
        cancel_url:
          type: string
          title: Cancel Url
          default: https://example.com/billing/cancel
      type: object
      required:
      - account_id
      title: CheckoutSessionRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SubscriptionStatusOut:
      properties:
        status:
          type: string
          title: Status
        on_trial:
          type: boolean
          title: On Trial
        trial_days_left:
          type: integer
          title: Trial Days Left
        needs_subscription:
          type: boolean
          title: Needs Subscription
        current_period_end:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Current Period End
        price_monthly_cents:
          type: integer
          title: Price Monthly Cents
        price_yearly_cents:
          type: integer
          title: Price Yearly Cents
        trial_days:
          type: integer
          title: Trial Days
      type: object
      required:
      - status
      - on_trial
      - trial_days_left
      - needs_subscription
      - price_monthly_cents
      - price_yearly_cents
      - trial_days
      title: SubscriptionStatusOut
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- corapilot-com-openapi.json
- corapilot-com-openapi.yml