Billingo API v3 API

by billingo.hu

API keyHTTPSFinance

Overview

This is a Billingo API v3 documentation. Our API based on REST software architectural style. API has resource-oriented URLs, accepts JSON-encoded request bodies and returns JSON-encoded responses. To use this API you have to generate a new API key on our [site](https://app.billingo.hu/api-key). After that, you can test your API key on this page.

Billingo API v3 is a finance API from billingo.hu. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 31 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Unknown
Category: Finance
Base URL: https://api.billingo.hu/v3
Version: 3.0.7
Endpoints: 31
OpenAPI: Specification ↗
Spec updated: 2021-06-30

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.billingo.hu/v3/bank-accounts" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.billingo.hu/v3/bank-accounts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.billingo.hu/v3/bank-accounts",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/bank-accounts`	List all bank account
POST	`/bank-accounts`	Create a bank account
GET	`/bank-accounts/{id}`	Retrieve a bank account
PUT	`/bank-accounts/{id}`	Update a bank account
DELETE	`/bank-accounts/{id}`	Delete a bank account
GET	`/currencies`	Get currencies exchange rate.
GET	`/document-blocks`	List all document blocks
GET	`/documents`	List all documents
POST	`/documents`	Create a document
GET	`/documents/{id}`	Retrieve a document
POST	`/documents/{id}/cancel`	Cancel a document
POST	`/documents/{id}/create-from-proforma`	Create a document from proforma.
GET	`/documents/{id}/download`	Download a document in PDF format.
GET	`/documents/{id}/online-szamla`	Retrieve a document Online Számla status
GET	`/documents/{id}/payments`	Retrieve a payment histroy
PUT	`/documents/{id}/payments`	Update payment history
DELETE	`/documents/{id}/payments`	Delete all payment history on document
GET	`/documents/{id}/public-url`	Retrieve a document download public url.
POST	`/documents/{id}/send`	Send invoice to given email adresses.
GET	`/organization`	Retrieve a organization data.
GET	`/partners`	List all partners
POST	`/partners`	Create a partner
GET	`/partners/{id}`	Retrieve a partner
PUT	`/partners/{id}`	Update a partner
DELETE	`/partners/{id}`	Delete a partner
GET	`/products`	List all product
POST	`/products`	Create a product
GET	`/products/{id}`	Retrieve a product
PUT	`/products/{id}`	Update a product
DELETE	`/products/{id}`	Delete a product
GET	`/utils/convert-legacy-id/{id}`	Convert legacy ID to v3 ID.