Invoicing API

Generate PDF invoices, pro‑formas, debit/credit notes and receipts with i18n labels, flexible dates and strict validation.

API FAQ

Get API Key Buy Credits

What you can do

High‑quality PDFs

A4 output via DomPDF with multiple design themes.

i18n ready

Two‑letter lang + dictionary (e.g., en, bg).

Shipping with VAT

Add shipping as net + VAT rate; totals adjust automatically.

Flexible dates

Accepts Y-m-d, d/m/Y, d-m-Y, m/d/Y, etc.; normalized to Y-m-d.

Endpoint:

Try Live

99.9 % Uptime

302.5ms Response

10 req/s

0.5 Credits / request

Create Pro‑forma

POST https://api.yeb.to/v1/invoicing/proforma

Parameter Type Required Description

api_key string yes Your API key

lang string(2) opt Language code (default: en)

design enum opt classic|modern|elegant|minimal

currency string opt Currency sign (default: €)

currency_side enum opt before or after (default: after)

seller object yes Seller block

`seller.name`	string	yes	Seller name
`seller.address`	string	yes	Street, city, country
`seller.email`	email	yes	Billing email
`seller.vat_number`	string	opt	VAT ID
`seller.company_number`	string	opt	Registry ID
`seller.logo`	url	opt	Logo URL
`seller.phone`	string	opt	Contact

buyer object yes Buyer block

`buyer.name`	string	yes	Buyer name
`buyer.address`	string	yes	Billing address
`buyer.email`	email	yes	Email
`buyer.vat_number`	string	opt	VAT ID
`buyer.company_number`	string	opt	Registry ID
`buyer.phone`	string	opt	Contact

items array<object> opt Line items (required fields when present)

`items[].name`	string	yes*	Item name
`items[].description`	string	opt	Item description
`items[].quantity`	number	yes*	Quantity
`items[].unit_price`	number	yes*	Unit price (net)
`items[].vat_rate`	number	yes*	VAT rate %
`items[].total_price`	number	yes*	Gross line total

shipping object opt Shipping as net + VAT rate

`shipping.price`	number	yes*	Shipping net
`shipping.vat_rate`	number	yes*	VAT rate % (0..100)

issue_date date yes Accepted formats; normalized to Y-m-d

valid_due_date date yes Offer valid until (accepted formats; normalized to Y-m-d)

extras array<object> opt Extra rows printed at bottom

`extras[].label`	string	yes*	Left cell
`extras[].value`	string	opt	Right cell

Example

curl -X POST https://api.yeb.to/v1/invoicing/proforma \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "lang": "en",
    "design": "elegant",
    "currency": "€",
    "currency_side": "after",
    "seller": {"name":"My Company Ltd.","address":"1 Seller St, City, Country","email":"[email protected]","vat_number":"BG123456789"},
    "buyer":  {"name":"Client Inc.","address":"2 Buyer Rd, City, Country","email":"[email protected]","vat_number":"DE987654321"},
    "issue_date": "2025-07-23",
    "valid_due_date": "2025-08-06",
    "items": [
      {"name":"Consulting Session","description":"Remote IT consulting (2h)","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240},
      {"name":"Software License","description":"1-year subscription","quantity":1,"unit_price":200,"vat_rate":20,"total_price":240}
    ],
    "shipping": {"price":25,"vat_rate":20},
    "extras":[{"label":"Notes","value":"Pro‑forma valid for 14 days"}]
  }'

Integrations

curl -X POST https://api.yeb.to/v1/invoicing/proforma -H "Content-Type: application/json" -d '{"api_key":"YOUR_KEY","seller":{"name":"My Company Ltd.","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client Inc.","address":"2 Buyer Rd","email":"[email protected]"},"issue_date":"2025-07-23","valid_due_date":"2025-08-06","items":[{"name":"Consulting","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240}]}'

$r = Http::post('https://api.yeb.to/v1/invoicing/proforma', [
  'api_key' => 'YOUR_KEY',
  'seller' => ['name'=>'My Company Ltd.','address'=>'1 Seller St','email'=>'[email protected]'],
  'buyer'  => ['name'=>'Client Inc.','address'=>'2 Buyer Rd','email'=>'[email protected]'],
  'issue_date' => '2025-07-23',
  'valid_due_date' => '2025-08-06',
  'items' => [['name'=>'Consulting','quantity'=>2,'unit_price'=>100,'vat_rate'=>20,'total_price'=>240]],
  'shipping' => ['price'=>25,'vat_rate'=>20]
]); echo $r->json();

fetch('https://api.yeb.to/v1/invoicing/proforma',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({api_key:'YOUR_KEY',seller:{name:'My Company Ltd.',address:'1 Seller St',email:'[email protected]'},buyer:{name:'Client Inc.',address:'2 Buyer Rd',email:'[email protected]'},issue_date:'2025-07-23',valid_due_date:'2025-08-06',items:[{name:'Consulting',quantity:2,unit_price:100,vat_rate:20,total_price:240}],shipping:{price:25,vat_rate:20}})}).then(r=>r.json()).then(console.log);

import requests, json
payload = {"api_key":"YOUR_KEY",
  "seller":{"name":"My Company Ltd.","address":"1 Seller St","email":"[email protected]"},
  "buyer":{"name":"Client Inc.","address":"2 Buyer Rd","email":"[email protected]"},
  "issue_date":"2025-07-23","valid_due_date":"2025-08-06",
  "items":[{"name":"Consulting","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240}],
  "shipping":{"price":25,"vat_rate":20}}
r = requests.post('https://api.yeb.to/v1/invoicing/proforma', headers={'Content-Type':'application/json'}, data=json.dumps(payload))
print(r.json())

Response Example

{
  "result": {
    "doc_type": "proforma",
    "file_url": "https://cdn.yourcdn.com/invoices/uuid.pdf",
    "expires": "2025-08-01 10:05:00"
  }
}

{
  "error": "valid_due_date is required for a pro‑forma invoice.",
  "code": 422
}

Response Codes

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Create Invoice

POST https://api.yeb.to/v1/invoicing/invoice

Parameter Type Required Description

api_key string yes Your API key

lang string(2) opt Language code (default: en)

design enum opt classic|modern|elegant|minimal

currency string opt Currency sign (default: €)

currency_side enum opt before or after (default: after)

seller object yes Seller block

`seller.name`	string	yes	Seller name
`seller.address`	string	yes	Street, city, country
`seller.email`	email	yes	Billing email
`seller.vat_number`	string	opt	VAT ID
`seller.company_number`	string	opt	Registry ID
`seller.logo`	url	opt	Logo URL
`seller.phone`	string	opt	Contact

buyer object yes Buyer block

`buyer.name`	string	yes	Buyer name
`buyer.address`	string	yes	Billing address
`buyer.email`	email	yes	Email
`buyer.vat_number`	string	opt	VAT ID
`buyer.company_number`	string	opt	Registry ID
`buyer.phone`	string	opt	Contact

items array<object> opt Line items (required fields when present)

`items[].name`	string	yes*	Item name
`items[].description`	string	opt	Item description
`items[].quantity`	number	yes*	Quantity
`items[].unit_price`	number	yes*	Unit price (net)
`items[].vat_rate`	number	yes*	VAT rate %
`items[].total_price`	number	yes*	Gross line total

shipping object opt Shipping as net + VAT rate

`shipping.price`	number	yes*	Shipping net
`shipping.vat_rate`	number	yes*	VAT rate % (0..100)

invoice_number string yes Invoice ID/number

issue_date date yes Accepted formats; normalized to Y-m-d

tax_event_date date yes Tax event date

subtotal number yes Net subtotal (items + shipping)

vat_total number yes Total VAT

total_amount_due number yes Grand total (gross)

payment_methods array<object> opt Payment instructions

`payment_methods[].method`	string	yes*	e.g., bank transfer, PayPal, card
`payment_methods[].details`	object	opt	Free‑shape key/value (IBAN, etc.)

extras array<object> opt Extra rows printed at bottom

`extras[].label`	string	yes*	Left cell
`extras[].value`	string	opt	Right cell

Example

curl -X POST https://api.yeb.to/v1/invoicing/invoice \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_KEY",
    "lang": "bg",
    "design": "elegant",
    "currency": "$",
    "currency_side": "before",
    "seller": {"name":"My Company Ltd.","address":"1 Seller St, City, Country","email":"[email protected]","vat_number":"BG123456789"},
    "buyer":  {"name":"Client Inc.","address":"2 Buyer Rd, City, Country","email":"[email protected]","vat_number":"DE987654321"},
    "invoice_number": "INV-2025-002",
    "issue_date": "2025-07-23",
    "tax_event_date": "2025-07-23",
    "items": [
      {"name":"Consulting Session","description":"Remote IT consulting (2h)","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240},
      {"name":"Software License","description":"1-year subscription","quantity":1,"unit_price":200,"vat_rate":20,"total_price":240}
    ],
    "shipping": {"price":25,"vat_rate":20},
    "subtotal": 425,
    "vat_total": 85,
    "total_amount_due": 510,
    "payment_methods": [
      {"method":"bank transfer","details":{"bank_name":"First Bank","iban":"BG00BANK00000000000000","bic":"BANKBGSF"}},
      {"method":"PayPal","details":{"email":"[email protected]"}}
    ],
    "extras":[{"label":"Notes","value":"Pay within 14 days"}]
  }'

Integrations

curl -X POST https://api.yeb.to/v1/invoicing/invoice -H "Content-Type: application/json" -d '{"api_key":"YOUR_KEY","seller":{"name":"My Company Ltd.","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client Inc.","address":"2 Buyer Rd","email":"[email protected]"},"invoice_number":"INV-2025-002","issue_date":"2025-07-23","tax_event_date":"2025-07-23","items":[{"name":"Consulting","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240}],"shipping":{"price":25,"vat_rate":20},"subtotal":225,"vat_total":45,"total_amount_due":270}'

$r = Http::post('https://api.yeb.to/v1/invoicing/invoice', [
  'api_key' => 'YOUR_KEY',
  'seller' => ['name'=>'My Company Ltd.','address'=>'1 Seller St','email'=>'[email protected]'],
  'buyer'  => ['name'=>'Client Inc.','address'=>'2 Buyer Rd','email'=>'[email protected]'],
  'invoice_number' => 'INV-2025-002',
  'issue_date' => '2025-07-23',
  'tax_event_date' => '2025-07-23',
  'items' => [['name'=>'Consulting','quantity'=>2,'unit_price'=>100,'vat_rate'=>20,'total_price'=>240]],
  'shipping' => ['price'=>25,'vat_rate'=>20],
  'subtotal' => 225, 'vat_total' => 45, 'total_amount_due' => 270
]); echo $r->json();

fetch('https://api.yeb.to/v1/invoicing/invoice',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({api_key:'YOUR_KEY',seller:{name:'My Company Ltd.',address:'1 Seller St',email:'[email protected]'},buyer:{name:'Client Inc.',address:'2 Buyer Rd',email:'[email protected]'},invoice_number:'INV-2025-002',issue_date:'2025-07-23',tax_event_date:'2025-07-23',items:[{name:'Consulting',quantity:2,unit_price:100,vat_rate:20,total_price:240}],shipping:{price:25,vat_rate:20},subtotal:225,vat_total:45,total_amount_due:270})}).then(r=>r.json()).then(console.log);

import requests, json
payload = {"api_key":"YOUR_KEY",
  "seller":{"name":"My Company Ltd.","address":"1 Seller St","email":"[email protected]"},
  "buyer":{"name":"Client Inc.","address":"2 Buyer Rd","email":"[email protected]"},
  "invoice_number":"INV-2025-002","issue_date":"2025-07-23","tax_event_date":"2025-07-23",
  "items":[{"name":"Consulting","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240}],
  "shipping":{"price":25,"vat_rate":20},"subtotal":225,"vat_total":45,"total_amount_due":270}
r = requests.post('https://api.yeb.to/v1/invoicing/invoice', headers={'Content-Type':'application/json'}, data=json.dumps(payload))
print(r.json())

Response Example

{
  "result": {
    "doc_type": "invoice",
    "file_url": "https://cdn.yourcdn.com/invoices/uuid.pdf",
    "expires": "2025-08-01 10:05:00"
  }
}

{
  "error": "invoice_number is required for an invoice.",
  "code": 422
}

Response Codes

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Create Debit Note

POST https://api.yeb.to/v1/invoicing/debit-note

Parameter Type Required Description

seller object yes Seller

`seller.name`	string	yes	Name
`seller.address`	string	yes	Address
`seller.email`	email	yes	Email

buyer object yes Buyer

`buyer.name`	string	yes	Name
`buyer.address`	string	yes	Address
`buyer.email`	email	yes	Email

items array<object> opt Lines for the note

`items[].name`	string	yes*	Item name
`items[].quantity`	number	yes*	Qty
`items[].unit_price`	number	yes*	Unit (net)
`items[].vat_rate`	number	yes*	VAT %
`items[].total_price`	number	yes*	Gross

debit_amount number opt Used when no items are provided

debit_note_number string yes Note number

invoice_number string yes Related invoice

issue_date date yes Date (multi‑format)

reason string yes Why the debit

payment_methods array<object> opt How to pay

`payment_methods[].method`	string	yes*	Method
`payment_methods[].details`	object	opt	Details (IBAN, etc.)

Example

curl -X POST https://api.yeb.to/v1/invoicing/debit-note \
 -H "Content-Type: application/json" \
 -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"debit_note_number":"DN-2025-003","invoice_number":"INV-2025-002","issue_date":"2025-07-25","reason":"Additional billable hours (3h)","items":[{"name":"Extra Consulting","description":"On-site work","quantity":3,"unit_price":40,"vat_rate":20,"total_price":144}]}'

curl -X POST https://api.yeb.to/v1/invoicing/debit-note -H "Content-Type: application/json" -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"debit_note_number":"DN-2025-003","invoice_number":"INV-2025-002","issue_date":"2025-07-25","reason":"Additional billable hours (3h)","debit_amount":144}'

$r = Http::post('https://api.yeb.to/v1/invoicing/debit-note', {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "debit_note_number": "DN-2025-003",
    "invoice_number": "INV-2025-002",
    "issue_date": "2025-07-25",
    "reason": "Additional billable hours (3h)",
    "debit_amount": 144
});
echo $r->json();

fetch('https://api.yeb.to/v1/invoicing/debit-note', { method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify({"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"debit_note_number":"DN-2025-003","invoice_number":"INV-2025-002","issue_date":"2025-07-25","reason":"Additional billable hours (3h)","debit_amount":144}) })
  .then(r => r.json()).then(console.log);

import requests, json
payload = {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "debit_note_number": "DN-2025-003",
    "invoice_number": "INV-2025-002",
    "issue_date": "2025-07-25",
    "reason": "Additional billable hours (3h)",
    "debit_amount": 144
}
                r = requests.post('https://api.yeb.to/v1/invoicing/debit-note', headers={'Content-Type':'application/json'}, data=json.dumps(payload))
print(r.json())

Response Example

{"result":{"doc_type":"debit-note","file_url":"https://cdn/.../uuid.pdf","expires":"2025-08-01 10:05:00"}}

{"error":"debit_note_number is required for a debit note.","code":422}

Response Codes

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Create Credit Note

POST https://api.yeb.to/v1/invoicing/credit-note

Parameter Type Required Description

seller object yes Seller

`seller.name`	string	yes	Name
`seller.address`	string	yes	Address
`seller.email`	email	yes	Email

buyer object yes Buyer

`buyer.name`	string	yes	Name
`buyer.address`	string	yes	Address
`buyer.email`	email	yes	Email

items array<object> opt Lines to credit

`items[].name`	string	yes*	Name
`items[].quantity`	number	yes*	Qty
`items[].unit_price`	number	yes*	Unit (net)
`items[].vat_rate`	number	yes*	VAT %
`items[].total_price`	number	yes*	Gross

credit_amount number opt When no items

credit_note_number string yes Note number

invoice_number string yes Related invoice

issue_date date yes Date (multi‑format)

reason string yes Why the credit

payment_methods array<object> opt Refund details

`payment_methods[].method`	string	yes*	Method
`payment_methods[].details`	object	opt	Details

Example

curl -X POST https://api.yeb.to/v1/invoicing/credit-note \
 -H "Content-Type: application/json" \
 -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"credit_note_number":"CN-2025-001","invoice_number":"INV-2025-002","issue_date":"2025-07-26","reason":"Refund for unused support hours","items":[{"name":"Support Hours","description":"Unused","quantity":1,"unit_price":200,"vat_rate":20,"total_price":240}]}'

curl -X POST https://api.yeb.to/v1/invoicing/credit-note -H "Content-Type: application/json" -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"credit_note_number":"CN-2025-001","invoice_number":"INV-2025-002","issue_date":"2025-07-26","reason":"Refund for unused support hours","credit_amount":240}'

$r = Http::post('https://api.yeb.to/v1/invoicing/credit-note', {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "credit_note_number": "CN-2025-001",
    "invoice_number": "INV-2025-002",
    "issue_date": "2025-07-26",
    "reason": "Refund for unused support hours",
    "credit_amount": 240
});
echo $r->json();

fetch('https://api.yeb.to/v1/invoicing/credit-note', { method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify({"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"credit_note_number":"CN-2025-001","invoice_number":"INV-2025-002","issue_date":"2025-07-26","reason":"Refund for unused support hours","credit_amount":240}) })
  .then(r => r.json()).then(console.log);

import requests, json
payload = {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "credit_note_number": "CN-2025-001",
    "invoice_number": "INV-2025-002",
    "issue_date": "2025-07-26",
    "reason": "Refund for unused support hours",
    "credit_amount": 240
}
                r = requests.post('https://api.yeb.to/v1/invoicing/credit-note', headers={'Content-Type':'application/json'}, data=json.dumps(payload))
print(r.json())

Response Example

{"result":{"doc_type":"credit-note","file_url":"https://cdn/.../uuid.pdf","expires":"2025-08-01 10:05:00"}}

{"error":"credit_note_number is required for a credit note.","code":422}

Response Codes

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Create Receipt

POST https://api.yeb.to/v1/invoicing/receipt

Parameter Type Required Description

seller object yes Seller

`seller.name`	string	yes	Name
`seller.address`	string	yes	Address
`seller.email`	email	yes	Email

buyer object yes Buyer

`buyer.name`	string	yes	Name
`buyer.address`	string	yes	Address
`buyer.email`	email	yes	Email

items array<object> opt Receipt lines; if missing, use amount_paid

`items[].name`	string	yes*	Name
`items[].quantity`	number	yes*	Qty
`items[].unit_price`	number	yes*	Unit (net)
`items[].vat_rate`	number	yes*	VAT %
`items[].total_price`	number	yes*	Gross

amount_paid number opt Used when no items

receipt_number string yes Receipt no.

payment_date date yes Date (multi‑format)

invoice_number string opt Related invoice (optional)

payment_method string opt Short method label

payment_methods array<object> opt Detailed method objects

`payment_methods[].method`	string	yes*	Method
`payment_methods[].details`	object	opt	Details

Example

curl -X POST https://api.yeb.to/v1/invoicing/receipt \
 -H "Content-Type: application/json" \
 -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"receipt_number":"RCPT-2025-010","payment_date":"2025-07-25","invoice_number":"INV-2025-002","items":[{"name":"Consulting","quantity":2,"unit_price":100,"vat_rate":20,"total_price":240}],"payment_methods":[{"method":"card","details":{"brand":"Visa","last4":"1234"}}]}'

curl -X POST https://api.yeb.to/v1/invoicing/receipt -H "Content-Type: application/json" -d '{"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"receipt_number":"RCPT-2025-010","payment_date":"2025-07-25","amount_paid":200,"payment_method":"cash"}'

$r = Http::post('https://api.yeb.to/v1/invoicing/receipt', {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "receipt_number": "RCPT-2025-010",
    "payment_date": "2025-07-25",
    "amount_paid": 200,
    "payment_method": "cash"
});
echo $r->json();

fetch('https://api.yeb.to/v1/invoicing/receipt', { method:'POST', headers:{'Content-Type':'application/json'}, body: JSON.stringify({"api_key":"YOUR_KEY","seller":{"name":"My Co","address":"1 Seller St","email":"[email protected]"},"buyer":{"name":"Client","address":"2 Buyer Rd","email":"[email protected]"},"receipt_number":"RCPT-2025-010","payment_date":"2025-07-25","amount_paid":200,"payment_method":"cash"}) })
  .then(r => r.json()).then(console.log);

import requests, json
payload = {
    "api_key": "YOUR_KEY",
    "seller": {
        "name": "My Co",
        "address": "1 Seller St",
        "email": "[email protected]"
    },
    "buyer": {
        "name": "Client",
        "address": "2 Buyer Rd",
        "email": "[email protected]"
    },
    "receipt_number": "RCPT-2025-010",
    "payment_date": "2025-07-25",
    "amount_paid": 200,
    "payment_method": "cash"
}
                r = requests.post('https://api.yeb.to/v1/invoicing/receipt', headers={'Content-Type':'application/json'}, data=json.dumps(payload))
print(r.json())

Response Example

{"result":{"doc_type":"receipt","file_url":"https://cdn/.../uuid.pdf","expires":"2025-08-01 10:05:00"}}

{"error":"payment_date is required for a receipt.","code":422}

Response Codes

Code	Description
200 Success	Request processed OK.
400 Bad Request	Input validation failed.
401 Unauthorized	Missing / wrong API key.
403 Forbidden	Key inactive or not allowed.
429 Rate Limit	Too many requests.
500 Server Error	Unexpected failure.

Frequently Asked Questions

Invoices, pro‑forma invoices, debit notes, credit notes and receipts.

Send a "shipping" object with "price" (net) and "vat_rate" (%). It is included in subtotal and VAT totals.

Y-m-d, d-m-Y, d/m/Y, d/m/y, m/d/Y, m/d/y. The API normalizes them to Y-m-d.

No. "receipt.invoice_number" is optional.

Yes. Pass a 2‑letter "lang" iso2 code and the server uses the matching dictionary with English fallback.

Yes. Every request, even those resulting in errors, consumes credits. This is because your credits are strictly tied to the number of requests, regardless of success or failure. However, if the error is clearly due to a platform problem on our end, we’ll recover those credits for you.

Contact us at [email protected]. We take feedback seriously—if your bug report or feature request is meaningful, we can fix or improve the API quickly and grant you 50 free credits as a thank you.

It depends on the API and sometimes even on the endpoint. Some endpoints use data from external sources, which may have stricter limits. We also enforce limits to prevent abuse and keep our platform stable. Check the docs for the specific rate limit for each endpoint.

We operate on a credit system. Buy once—credits never expire. They’re non-refundable units for making API calls (requests). Simple, fair, and you top up only when you need more.

Every HTTP call is one request. Each request consumes a number of credits depending on the endpoint. In most cases, you can make thousands of requests with just one credit—but always check each endpoint for its cost.

Yes. Your credits never expire until you use them, but they are non-refundable.

Credits are non-refundable. Only buy what you need—you can always top-up later. If we screw up and it costs you, we’ll fix it.

Prices are set in credits, not dollars. Each endpoint lists its own cost—see the “Credits / request” badge above. You’ll always know exactly what you’re spending.

← Back to APIs

Get credits to unlock premium content and features

$10

100 credits

Invoicing API

What you can do

High‑quality PDFs

i18n ready

Shipping with VAT

Flexible dates

Create Pro‑forma

Example

Integrations

Response Example

Response Codes

Create Invoice

Example

Integrations

Response Example

Response Codes

Create Debit Note

Example

Response Example

Response Codes

Create Credit Note

Example

Response Example

Response Codes

Create Receipt

Example

Response Example

Response Codes

Frequently Asked Questions

Which documents can I generate?

How do I add shipping with VAT?

What date formats are accepted?

Is the related invoice required on a receipt?

Can I localize labels on the PDFs?

Do requests with errors count and cost credits?

I found a bug or want customizations in the APIs. What do I do?

What is the rate limit?

How does payment and usage work?

What’s the difference between a credit and a request?

Do unused credits roll over?

Do you offer refunds?

How much does each API call cost?