# Endpoints

> The számlázz.hu API endpoints, relative to the base URL. The exact parameters are in the OpenAPI specification.

Paths are relative to the base URL (`https://api.uptools.io/szamlazz-hu/v1`). The exact structure of requests and responses is in the OpenAPI specification: [`https://api.uptools.io/szamlazz-hu/v1/openapi.json`](https://api.uptools.io/szamlazz-hu/v1/openapi.json).

## Invoices

| Method | Path | Purpose |
|---|---|---|
| `POST` | `/invoices` | Issue an invoice |
| `POST` | `/invoices/prepayment` | Prepayment invoice |
| `POST` | `/invoices/final` | Final invoice |
| `POST` | `/invoices/corrective` | Corrective invoice |
| `POST` | `/invoices/reverse` | Reversal (storno) |
| `GET` | `/invoices/exists` | Check whether an invoice exists |
| `GET` | `/invoices/{number}` | Get an invoice |
| `GET` | `/invoices/{number}/pdf` | Invoice as PDF |
| `POST` | `/invoices/{number}/payment` | Record a payment |

## Receipts

| Method | Path | Purpose |
|---|---|---|
| `POST` | `/receipts` | Issue a receipt |
| `POST` | `/receipts/reverse` | Reverse a receipt |
| `GET` | `/receipts/{number}` | Get a receipt |
| `GET` | `/receipts/{number}/pdf` | Receipt as PDF |
| `POST` | `/receipts/{number}/send` | Send a receipt |

## Pro forma invoices, delivery notes, tax numbers

| Method | Path | Purpose |
|---|---|---|
| `POST` | `/proformas` | Issue a pro forma invoice |
| `DELETE` | `/proformas/{number}` | Delete a pro forma invoice |
| `POST` | `/delivery-notes` | Delivery note |
| `GET` | `/taxpayers/{taxNumber}` | Tax number lookup |

## Other

| Method | Path | Purpose |
|---|---|---|
| `GET` | `/health` | Whether the service is up |
| `GET` | `/openapi.json` | The OpenAPI 3.1 description |