Yona API for developers

Build e-invoicing into your own systems.

Create a Yona account, get an API key, and issue invoices from your ERP, accounting system or storefront. Yona gives each one its IRN and QR code, delivers it and reports it to the NRS. Same plans and credits as the app.

Get startedRead the quickstart

Test with a sandbox key first; a live key sends real invoices.

# Create an invoice with a sandbox key
curl -X POST https://gp.useyona.com/i/v1/invoices \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d @invoice.json

# Submit it: the IRN and QR code come back
curl -X POST "https://gp.useyona.com/i/v1/invoices/INVOICE_ID/submit?finalise=true" \
  -H "Authorization: Bearer sk_test_…"

From sign-up to your first invoice.

Self-serve. No application, no approval: sign up and start in the sandbox.

  1. 01

    Create your account

    Sign up at app.useyona.com and verify your business with its TIN.

  2. 02

    Get an API key

    Create sandbox and live keys in your dashboard. The key decides which one you are working in.

  3. 03

    Issue invoices from your system

    Create an invoice, submit it and get back its IRN and QR code. Webhooks tell you when anything changes.

  4. 04

    Connect and go live

    Select Elyonar as your Access Point on the portal of the NRS, connect in Yona, and switch to your live key.

What the API covers.

The same API the Yona app is built on.

Invoices

Create, validate, submit and track them, and download the signed PDF. Correct with credit and debit notes.

Buyers and items

Keep your customers and products in Yona, and check a buyer before you invoice.

Received invoices

Invoices other businesses send you through the e-invoicing network.

Signed webhooks

A signed notification on every status change, so you can verify it came from us.

Organisations and teams

Run several organisations from one account, and manage members, roles, invitations and API keys.

Tax connection

Connect to the NRS and upload your signing key through the API.

REST API

API keys and signed webhooks

Create API keys in your dashboard and get notified the moment an invoice changes.

SDK

@useyona/einvoice-js

A typed JavaScript and TypeScript library for invoicing from your own app.

MCP server

@elyonar/einvoice-mcp

Work with your Yona invoices from any MCP-compatible tool.

Two ways to build with Yona.

Pick the one that matches how you run e-invoicing.

The Yona API (this page)

You want Yona to do the e-invoicing for your business or group, from your own systems. Sign up and start today.

Get started

The Access Point partner programme

You are a system integrator or ERP running your own integration, and need a licensed Access Point to reach the NRS.

See the partner programme

Start building in the sandbox today.

Create your account, get a sandbox key and issue your first test invoice in about ten minutes.

Get startedRead the docs