# Getting started

> A REST/JSON interface on top of the számlázz.hu Számla Agent. You call it with your own számlázz.hu Agent key, no separate API key needed.

A REST/JSON interface on top of the számlázz.hu Számla Agent: invoices, receipts, pro forma invoices, delivery notes and tax number lookup. You call it with your own számlázz.hu Agent key, no separate API key needed.

## Base URL

```text
https://api.uptools.io/szamlazz-hu/v1
```

## Authentication

Except for `/health` and `/openapi.json`, every endpoint expects your számlázz.hu Agent key in the `X-Szamlazz-Agent-Key` header. Instead of that header you can also use `Authorization: Bearer <key>`.

```bash
curl https://api.uptools.io/szamlazz-hu/v1/taxpayers/$TAX_NUMBER \
  -H "X-Szamlazz-Agent-Key: $SZAMLAZZ_AGENT_KEY"
```

> **Server side only**
>
> The Agent key can issue real invoices. Never put it in a browser or in client-side code: call the API from your own server.

## The full reference

The machine-readable description of the endpoints, in OpenAPI 3.1 format: [`https://api.uptools.io/szamlazz-hu/v1/openapi.json`](https://api.uptools.io/szamlazz-hu/v1/openapi.json). The version you can read in a browser: [`https://api.uptools.io/szamlazz-hu/v1/docs`](https://api.uptools.io/szamlazz-hu/v1/docs).