Cloudpepper Billing API

The Billing API from Cloudpepper — 1 operation(s) for billing.

GitHub OpenAPI

Operations 2

GET /billing-details Get billing details #
PATCH /billing-details Update billing details #

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/cloudpepper-io:cloudpepper-io-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

cloudpepper-io-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cloudpepper Io Billing API
  version: 1.0.0
  description: 'Operations tagged Billing across 2 of this provider''s published API definitions: cloudpepper-io-openapi.json, cloudpepper-io-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /
- url: https://api.cloudpepper.io
  description: Resolved from the published relative server "/" against the host serving the spec (https://api.cloudpepper.io/openapi.json)
security:
- bearerAuth: []
tags:
- name: Billing
paths:
  /billing-details:
    get:
      tags:
      - Billing
      summary: Get billing details
      description: 'Retrieve your Account''s billing details. These values appear on your invoices and are used for VAT validation and tax calculation. If you haven''t added billing details yet, every field is returned as `null` (with `isCompany` as `false`).


        Requires Account administrator privileges.'
      responses:
        '200':
          description: Billing details retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type:
                    - string
                    - 'null'
                    description: Company or billing contact name
                  vat:
                    type:
                    - string
                    - 'null'
                    description: VAT / tax identification number
                  isCompany:
                    type: boolean
                    description: Whether you are registered as a company (true) or an individual (false)
                  street:
                    type:
                    - string
                    - 'null'
                  street2:
                    type:
                    - string
                    - 'null'
                  city:
                    type:
                    - string
                    - 'null'
                  zip:
                    type:
                    - string
                    - 'null'
                  country:
                    type:
                    - string
                    - 'null'
                    description: ISO country code (e.g. 'BE', 'US')
                  email:
                    type:
                    - string
                    - 'null'
                    description: Billing email address
              example:
                name: Acme Corp
                vat: BE0123456789
                isCompany: true
                street: Rue de la Loi 16
                street2: null
                city: Brussels
                zip: '1000'
                country: BE
                email: billing@acme.example
        '403':
          description: Insufficient permissions (requires Account administrator privileges)
      operationId: getBillingDetails
      x-operation-id-source: derived
    patch:
      tags:
      - Billing
      summary: Update billing details
      description: 'Update your Account''s billing details. These values appear on your invoices and are used for VAT validation and tax calculation, so only valid entries are saved unrecognized input is rejected with an error rather than applied silently.


        This is a partial update: fields you omit are left unchanged; send an empty string to clear a field.


        **Key Parameters:**

        - `name`: Your company or billing name (required).

        - `vat`: VAT / tax identification number. Providing one marks you as a company; leaving it empty keeps your current company status. An invalid number is rejected.

        - `country`: ISO country code (e.g. ''BE'', ''US''). An unrecognized code is rejected; send an empty string to clear it.

        - `street`, `street2`, `city`, `zip`: Your billing address.

        - `email`: The address your invoices are sent to.


        Requires Account administrator privileges.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Company or billing contact name (required)
                vat:
                  type: string
                  description: VAT / tax identification number
                street:
                  type: string
                street2:
                  type: string
                city:
                  type: string
                zip:
                  type: string
                country:
                  type: string
                  description: ISO country code (e.g. 'BE', 'US'); empty string clears the country
                email:
                  type: string
                  description: Billing email address
              required:
              - name
            example:
              name: Acme Corp
              vat: BE0123456789
              street: Rue de la Loi 16
              street2: ''
              city: Brussels
              zip: '1000'
              country: BE
              email: billing@acme.example
        required: true
      responses:
        '200':
          description: Billing details updated successfully; returns the saved details
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type:
                    - string
                    - 'null'
                  vat:
                    type:
                    - string
                    - 'null'
                  isCompany:
                    type: boolean
                  street:
                    type:
                    - string
                    - 'null'
                  street2:
                    type:
                    - string
                    - 'null'
                  city:
                    type:
                    - string
                    - 'null'
                  zip:
                    type:
                    - string
                    - 'null'
                  country:
                    type:
                    - string
                    - 'null'
                  email:
                    type:
                    - string
                    - 'null'
              example:
                name: Acme Corp
                vat: BE0123456789
                isCompany: true
                street: Rue de la Loi 16
                street2: null
                city: Brussels
                zip: '1000'
                country: BE
                email: billing@acme.example
        '400':
          description: 'Invalid request: missing company name, unrecognized country code, invalid VAT number, or billing has not been set up for your Account yet'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Human-readable reason the billing details could not be saved
              example:
                error: The selected country is not recognized.
        '403':
          description: Insufficient permissions (requires Account administrator privileges)
      operationId: patchBillingDetails
      x-operation-id-source: derived
    servers:
    - url: /
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- cloudpepper-io-openapi.json
- cloudpepper-io-openapi.yml