HowToRomania Billing API

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

GitHub OpenAPI

Operations 1

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

howtoromania-io-billing-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HowToRomania Billing API
  version: 0.5.0
  description: 'Data from Romanian public registries for AI agents. €5 = 1,000 credits (€0.005/credit) · €20 = 5,000 · €100 = 30,000. 100 free credits per key. Errors, not-found and source outages (e.g. ANAF unreachable) are not billed; a risk report with some sections unavailable is billed in full. Demo key: htr_demo (limited daily calls per IP; company.lookup, court.case, efactura.validate, efactura.parse, legislation.search, legislation.article, legislation.new).'
  contact:
    email: hello@howtoromania.io
    url: https://howtoromania.io
servers:
- url: https://api.howtoromania.io
security:
- apiKey: []
- bearer: []
tags:
- name: Billing
paths:
  /v1/billing/checkout:
    get:
      operationId: get_checkout_link
      summary: Get a checkout link for a credit pack
      description: 'Buying credits: GET /v1/billing/checkout?pack=starter|pro|scale with your key returns a checkoutUrl valid 30 minutes; a human opens it, accepts the Terms, chooses consumer or business (business: company name, CUI or EU VAT ID, country), then pays on Stripe (merchant of record). Credits are added automatically after payment.'
      tags:
      - Billing
      parameters:
      - name: pack
        in: query
        required: true
        description: 'Credit pack id: starter, pro or scale'
        schema:
          type: string
          enum:
          - starter
          - pro
          - scale
          description: starter, pro or scale
      responses:
        '200':
          description: Checkout link
          content:
            application/json:
              schema:
                description: Short-lived checkout link
                type: object
                properties:
                  checkoutUrl:
                    description: URL a person opens to accept terms and pay. Valid 30 minutes
                    type: string
                    format: uri
                  consentRequired:
                    description: True. The buyer accepts the terms on that page
                    type: boolean
                  expiresInMinutes:
                    description: Minutes the link stays valid
                    type: integer
                  pack:
                    description: Pack id you asked for
                    type: string
                  credits:
                    description: Credits the pack adds after payment
                    type: integer
                  howTo:
                    description: What the person does on the checkout page
                    type: string
                required:
                - checkoutUrl
                - consentRequired
                - expiresInMinutes
                - pack
                - credits
        '400':
          description: invalid_pack
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: purchases_paused
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      description: Error body
      type: object
      properties:
        error:
          description: What went wrong
          type: object
          properties:
            code:
              description: Stable code, e.g. invalid_input, not_found, unauthorized, rate_limited, insufficient_credits
              type: string
            message:
              description: What went wrong, and whether the call was billed
              type: string
            retryAfterSeconds:
              description: Seconds to wait, on some rate-limit responses
              type: integer
            balance:
              description: Credit balance, on some billing errors
              type: integer
          additionalProperties: true
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key, or the public demo key on the endpoints that accept it
    bearer:
      type: http
      scheme: bearer
      description: 'Same API key as a bearer token: Authorization: Bearer <key>'
externalDocs:
  url: https://api.howtoromania.io/docs
x-mcp:
  url: https://api.howtoromania.io/mcp
  transport: streamable-http