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: Bol.ai Billing API
version: 1.0.0
description: Freight-document data extraction. Upload a Bill of Lading, commercial invoice, packing list or CMR road waybill (PDF/PNG/JPG); the document type is detected automatically and returned as doc_type, with a field set tailored to that type. Fields not present in the document are null — never guessed. One document = one usage unit regardless of type. Documents and data are stored exclusively in the EU.
contact:
url: https://bol.ai
servers:
- url: https://bol.ai
security:
- apiKey: []
tags:
- name: Billing
paths:
/api/billing/buy-credits:
post:
summary: Create a credit-pack checkout link
description: Returns a Stripe Checkout URL for a one-time credit pack. No charge happens on this call — an agent can fetch the link and hand it to a human, who completes payment on Stripe's hosted page.
responses:
'200':
description: '{ url } — Stripe Checkout URL'
tags:
- Billing
operationId: postApiBillingBuyCredits
x-operation-id-source: derived
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
description: 'Bol.ai API key (bolai_...). Create one in the app: https://bol.ai/app/ — available on the Professional plan or with credits; new accounts include 5 free documents.'