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.
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