---
title: Getting started with the Qvalia API
description: Shows how to obtain API access, create an API key and make a first test using the current API documentation.
---

[Skip to content](https://knowledge.qvalia.com/how-to-integrate-qvalia-to-erp-systems#main-content)

- [English](https://knowledge.qvalia.com/how-to-integrate-qvalia-to-erp-systems)
- [Svenska](https://knowledge.qvalia.com/sv/hur-integrerar-jag-qvalia-med-mitt-affärssystem-via-api)

English

Show submenu for translations

[Submit a ticket](https://knowledge.qvalia.com/kb-tickets/new?hsLang=en) [Customer portal](https://servicedesk.qvalia.com/tickets?hsLang=en)

![Qvalia Logo New Blue transparent.png\]](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png)

Open main navigation

Close main navigation

- - [English](https://knowledge.qvalia.com/how-to-integrate-qvalia-to-erp-systems)
    - [Svenska](https://knowledge.qvalia.com/sv/hur-integrerar-jag-qvalia-med-mitt-affärssystem-via-api)

  English
  
  Show submenu for translations
- [Submit a ticket](https://knowledge.qvalia.com/kb-tickets/new)
- [Customer portal](https://servicedesk.qvalia.com/tickets)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge base](https://knowledge.qvalia.com/?hsLang=en)
2. [Integrations](https://knowledge.qvalia.com/integrations?hsLang=en)

# Getting started with the Qvalia API

## Use the current documentation at api.qvalia.io for endpoints, payloads and responses. API access requires a plan or agreement covering the function and environment you need.

1. Check under **Plans & Billing** or in your agreement that API access is included.
2. Open **Settings → API & SFTP settings** and create the API key. The key is shown once. Copy and store it straight away, as it cannot be retrieved later. If you need a new one, generate a replacement, which invalidates the old key.
3. Select the correct environment and base URL.
4. Follow the Quick Start and sample data at `api.qvalia.io`.
5. Test with representative documents before production.

### API key and authentication

The API key is environment-specific and must be treated as a secret. Do not place it in source code, logs, support emails or screenshots. Create a separate key for each environment and replace it if you suspect exposure.

Send the key in the header specified in the API documentation. If authentication fails, check both that the header is actually sent and that the key belongs to the environment of the base URL.

### Account numbers and identifiers

Enter `accountRegNo` and other account identifiers exactly as specified in the account setup and endpoint schema. Copy the value from the platform or onboarding information rather than constructing it yourself.

The recipient's Peppol ID must include both the scheme prefix and identifier and be registered for the document type.

### Start in test

- The Qvalia test environment can be used to send and receive all document types included in the agreed test setup.
- Test and production have separate URLs and API keys.
- Always check both the API response and the result in the transaction log.

### Move to production

Contact Qvalia when testing is complete. State which flows and document types were tested, whether you will send, receive or both, and the requested start date. Production access is activated after an agreement or accepted quotation.

### If it still does not work

- **Check once more:** the base URL, environment, API key, `accountRegNo`, endpoint, method and payload.
- **Have this ready when contacting support:** timestamp, endpoint, method, environment, response code, response body and correlation or transaction ID. Do not send the API key.
- **Contact support:** through the support form at the bottom of https://qvalia.com or at help@qvalia.com.

- [General](https://knowledge.qvalia.com/general?hsLang=en#main-content)

    - [Peppol](https://knowledge.qvalia.com/general?hsLang=en#peppol)
- [Partner](https://knowledge.qvalia.com/partner?hsLang=en)
- [Logs and monitoring](https://knowledge.qvalia.com/logs-and-monitoring?hsLang=en)
- [Integrations](https://knowledge.qvalia.com/integrations?hsLang=en)
- [Invoice management](https://knowledge.qvalia.com/invoice-management?hsLang=en)
- [Order management](https://knowledge.qvalia.com/order-management?hsLang=en)
- [Data management](https://knowledge.qvalia.com/data-management?hsLang=en)
- [Security and compliance](https://knowledge.qvalia.com/security-and-compliance?hsLang=en)
- [Account](https://knowledge.qvalia.com/account?hsLang=en)
- [Troubleshooting](https://knowledge.qvalia.com/troubleshooting?hsLang=en)

[![Chill listening crop-3](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?width=107&height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png "Chill listening crop-3")](https://qvalia.com/)

Knowledge base

Copyright © 2025, Qvalia