Cloudpepper Billing API
The Billing API from Cloudpepper — 1 operation(s) for billing.
The Billing API from Cloudpepper — 1 operation(s) for 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/cloudpepper-io:cloudpepper-io-billing-api"
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.
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: 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