Aveco

Aveco Billing API

The Billing API from Aveco — 21 operation(s) for billing.

GitHub OpenAPI

Operations 22

GET /api/billing/plans Billing Plans #
GET /api/billing/summary Billing Summary #
GET /api/billing/transactions Billing Transactions #
POST /api/billing/enterprise-lead Billing Enterprise Lead #
POST /api/billing/wallet/topup Billing Wallet Topup #
GET /api/billing/wallet/payment-methods Billing Wallet List Payment Methods #
POST /api/billing/wallet/payment-methods/{payment_method_id}/default Billing Wallet Set Default Payment Method #
DELETE /api/billing/wallet/payment-methods/{payment_method_id} Billing Wallet Delete Payment Method #
GET /api/billing/wallet/transfer/eligible-projects Billing Wallet Transfer Eligible Projects #
POST /api/billing/wallet/transfer Billing Wallet Transfer #
GET /api/billing/wallet/balance Billing Wallet Balance #
GET /api/billing/wallet/auto-recharge Billing Wallet Get Auto Recharge #
POST /api/billing/wallet/auto-recharge Billing Wallet Set Auto Recharge #
GET /api/billing/wallet/activity Billing Wallet Activity #
GET /api/billing/pricing Billing Pricing #
GET /api/billing/pricing/public Billing Pricing Public #
GET /api/billing/wallet/spend-summary Billing Wallet Spend Summary #
GET /api/billing/wallet/export.csv Billing Wallet Export Csv #
POST /api/billing/wallet/precheck Billing Wallet Precheck #
GET /api/billing/wallet/spend-log Billing Wallet Spend Log #
POST /api/billing/webhook/oxapay Billing Webhook Oxapay #
POST /api/billing/webhook/stripe Billing Webhook Stripe #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/aveco-app/openapi/aveco-app-billing-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-body-outreach-telegram-b2b-campaign-update-outreach-telegram-b2b-campaign-campaign-id-update-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-body-update-whatsapp-campaign-api-outreach-whatsapp-campaigns-campaign-id-update-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-body-update-max-campaign-api-outreach-max-campaigns-campaign-id-update-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-agent-update-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-body-contacts-b2b-catalog-save-base-from-filter-api-contacts-b2b-catalog-bases-save-from-filter-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/aveco-app/json-schema/aveco-app-body-update-voice-campaign-api-outreach-voice-campaigns-campaign-id-update-post-schema.json

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/aveco-app:aveco-app-billing-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aveco-app-billing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Aveco Billing API
  version: 0.1.0
tags:
- name: Billing
paths:
  /api/billing/plans:
    get:
      summary: Billing Plans
      description: Return active public billing plans for frontend consumption.
      operationId: billing_plans_api_billing_plans_get
      parameters:
      - name: locale
        in: query
        required: false
        schema:
          type: string
          default: en
          title: Locale
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Plans Api Billing Plans Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/summary:
    get:
      summary: Billing Summary
      operationId: billing_summary_api_billing_summary_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Summary Api Billing Summary Get
      tags:
      - Billing
  /api/billing/transactions:
    get:
      summary: Billing Transactions
      description: 'Payment/transaction history — subscriptions and account rentals

        together, each with a human description of what it was for (not a raw

        "topup then spend" balance ledger).'
      operationId: billing_transactions_api_billing_transactions_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Transactions Api Billing Transactions Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/enterprise-lead:
    post:
      summary: Billing Enterprise Lead
      description: '"Large volumes? Contact us" request.


        The signed-in user is already known, so name/email come from the session; the legacy

        ``email`` / ``telegram_or_phone`` / ``accounts_count`` form fields are still accepted (and an

        email is still required for anonymous callers) but the cabinet no longer sends them. The

        topic is stored as a ``[topic]`` prefix of the message (no schema change). Saved to the DB and

        announced on the CONTACT Telegram channel, best-effort.'
      operationId: billing_enterprise_lead_api_billing_enterprise_lead_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_billing_enterprise_lead_api_billing_enterprise_lead_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Enterprise Lead Api Billing Enterprise Lead Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/topup:
    post:
      summary: Billing Wallet Topup
      operationId: billing_wallet_topup_api_billing_wallet_topup_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_billing_wallet_topup_api_billing_wallet_topup_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Topup Api Billing Wallet Topup Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/payment-methods:
    get:
      summary: Billing Wallet List Payment Methods
      operationId: billing_wallet_list_payment_methods_api_billing_wallet_payment_methods_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet List Payment Methods Api Billing Wallet Payment Methods Get
      tags:
      - Billing
  /api/billing/wallet/payment-methods/{payment_method_id}/default:
    post:
      summary: Billing Wallet Set Default Payment Method
      operationId: billing_wallet_set_default_payment_method_api_billing_wallet_payment_methods__payment_method_id__default_post
      parameters:
      - name: payment_method_id
        in: path
        required: true
        schema:
          type: integer
          title: Payment Method Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Set Default Payment Method Api Billing Wallet Payment Methods  Payment Method Id  Default Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/payment-methods/{payment_method_id}:
    delete:
      summary: Billing Wallet Delete Payment Method
      operationId: billing_wallet_delete_payment_method_api_billing_wallet_payment_methods__payment_method_id__delete
      parameters:
      - name: payment_method_id
        in: path
        required: true
        schema:
          type: integer
          title: Payment Method Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Delete Payment Method Api Billing Wallet Payment Methods  Payment Method Id  Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/transfer/eligible-projects:
    get:
      summary: Billing Wallet Transfer Eligible Projects
      operationId: billing_wallet_transfer_eligible_projects_api_billing_wallet_transfer_eligible_projects_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Transfer Eligible Projects Api Billing Wallet Transfer Eligible Projects Get
      tags:
      - Billing
  /api/billing/wallet/transfer:
    post:
      summary: Billing Wallet Transfer
      operationId: billing_wallet_transfer_api_billing_wallet_transfer_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_billing_wallet_transfer_api_billing_wallet_transfer_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Transfer Api Billing Wallet Transfer Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/balance:
    get:
      summary: Billing Wallet Balance
      operationId: billing_wallet_balance_api_billing_wallet_balance_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Balance Api Billing Wallet Balance Get
      tags:
      - Billing
  /api/billing/wallet/auto-recharge:
    get:
      summary: Billing Wallet Get Auto Recharge
      operationId: billing_wallet_get_auto_recharge_api_billing_wallet_auto_recharge_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Get Auto Recharge Api Billing Wallet Auto Recharge Get
      tags:
      - Billing
    post:
      summary: Billing Wallet Set Auto Recharge
      operationId: billing_wallet_set_auto_recharge_api_billing_wallet_auto_recharge_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_billing_wallet_set_auto_recharge_api_billing_wallet_auto_recharge_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Set Auto Recharge Api Billing Wallet Auto Recharge Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/activity:
    get:
      summary: Billing Wallet Activity
      description: 'One chronological feed of every balance movement (top-ups,

        auto-recharge, usage spend, transfers, credits) — the same ledger the CSV

        export reads, paged for the billing page. ``amount_cents`` is signed

        (negative = money out). ``has_more`` lets the UI show "Show more".'
      operationId: billing_wallet_activity_api_billing_wallet_activity_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
      - name: q
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Q
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Activity Api Billing Wallet Activity Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/pricing:
    get:
      summary: Billing Pricing
      description: 'Single price catalogue (contacts / data / AI), read from the same constants the

        charging code uses - never a second copy of the prices.'
      operationId: billing_pricing_api_billing_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Pricing Api Billing Pricing Get
      tags:
      - Billing
  /api/billing/pricing/public:
    get:
      summary: Billing Pricing Public
      description: 'Same catalogue as `/api/billing/pricing`, readable without a session, for the marketing /pricing page.


        Read-only and derived from the very constants the wallet charges with (`build_pricing_catalog`,

        `phone_discovery.policy`, `WALLET_MIN_TOPUP_USD`), so the public page cannot drift from the cabinet.'
      operationId: billing_pricing_public_api_billing_pricing_public_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Pricing Public Api Billing Pricing Public Get
      tags:
      - Billing
  /api/billing/wallet/spend-summary:
    get:
      summary: Billing Wallet Spend Summary
      description: 'Spend by category for a period. ``date_from``/``date_to`` are inclusive ISO dates

        (YYYY-MM-DD, UTC); default = the current calendar month so far.'
      operationId: billing_wallet_spend_summary_api_billing_wallet_spend_summary_get
      parameters:
      - name: date_from
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date From
      - name: date_to
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Date To
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Spend Summary Api Billing Wallet Spend Summary Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/export.csv:
    get:
      summary: Billing Wallet Export Csv
      description: 'Full ledger export for accounting — every balance movement

        (top-ups, auto-recharge, per-contact spend, transfers), not just the

        per-contact WalletSpendLog detail. Capped at the most recent 5000 rows;

        a heavier "full history" export can move to a background job if that

        ever proves too small in practice.'
      operationId: billing_wallet_export_csv_api_billing_wallet_export_csv_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Export Csv Api Billing Wallet Export Csv Get
      tags:
      - Billing
  /api/billing/wallet/precheck:
    post:
      summary: Billing Wallet Precheck
      description: 'Dry-run cost check for a campaign-launch confirmation screen — how

        much would activating this many contacts (by source) cost, and can the

        owner afford it right now. Never mutates the balance.'
      operationId: billing_wallet_precheck_api_billing_wallet_precheck_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_billing_wallet_precheck_api_billing_wallet_precheck_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Precheck Api Billing Wallet Precheck Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/wallet/spend-log:
    get:
      summary: Billing Wallet Spend Log
      operationId: billing_wallet_spend_log_api_billing_wallet_spend_log_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                title: Response Billing Wallet Spend Log Api Billing Wallet Spend Log Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Billing
  /api/billing/webhook/oxapay:
    post:
      summary: Billing Webhook Oxapay
      description: 'Handle Oxapay webhook – process successful payments.


        Verifies signature, deduplicates, records payment, updates subscription

        (shared with the Stripe webhook via _settle_gateway_payment).'
      operationId: billing_webhook_oxapay_api_billing_webhook_oxapay_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Billing Webhook Oxapay Api Billing Webhook Oxapay Post
      tags:
      - Billing
  /api/billing/webhook/stripe:
    post:
      summary: Billing Webhook Stripe
      description: 'Handle Stripe webhook – process completed Checkout Sessions.


        Verifies signature, deduplicates, records payment, updates subscription

        (shared with the Oxapay webhook via _settle_gateway_payment).'
      operationId: billing_webhook_stripe_api_billing_webhook_stripe_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Billing Webhook Stripe Api Billing Webhook Stripe Post
      tags:
      - Billing
components:
  schemas:
    Body_billing_wallet_set_auto_recharge_api_billing_wallet_auto_recharge_post:
      properties:
        is_enabled:
          type: boolean
          title: Is Enabled
        threshold_usd:
          type: number
          title: Threshold Usd
          default: 10.0
        topup_amount_usd:
          type: number
          title: Topup Amount Usd
          default: 50.0
        payment_method_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Payment Method Id
      type: object
      required:
      - is_enabled
      title: Body_billing_wallet_set_auto_recharge_api_billing_wallet_auto_recharge_post
    Body_billing_wallet_topup_api_billing_wallet_topup_post:
      properties:
        amount_usd:
          type: number
          title: Amount Usd
        payment_method:
          type: string
          title: Payment Method
      type: object
      required:
      - amount_usd
      title: Body_billing_wallet_topup_api_billing_wallet_topup_post
    Body_billing_wallet_transfer_api_billing_wallet_transfer_post:
      properties:
        from_project_id:
          type: integer
          title: From Project Id
        to_project_id:
          type: integer
          title: To Project Id
        amount_usd:
          type: number
          title: Amount Usd
        password:
          type: string
          title: Password
      type: object
      required:
      - from_project_id
      - to_project_id
      - amount_usd
      - password
      title: Body_billing_wallet_transfer_api_billing_wallet_transfer_post
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Body_billing_wallet_precheck_api_billing_wallet_precheck_post:
      properties:
        own_list:
          type: integer
          title: Own List
          default: 0
        ready_db:
          type: integer
          title: Ready Db
          default: 0
        parsed:
          type: integer
          title: Parsed
          default: 0
      type: object
      title: Body_billing_wallet_precheck_api_billing_wallet_precheck_post
    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
    Body_billing_enterprise_lead_api_billing_enterprise_lead_post:
      properties:
        name:
          type: string
          title: Name
          default: ''
        email:
          type: string
          title: Email
          default: ''
        telegram_or_phone:
          type: string
          title: Telegram Or Phone
          default: ''
        accounts_count:
          type: integer
          title: Accounts Count
          default: 0
        message:
          type: string
          title: Message
          default: ''
        topic:
          type: string
          title: Topic
          default: ''
      type: object
      title: Body_billing_enterprise_lead_api_billing_enterprise_lead_post