API Reference & Documentation

API Accounts and Authentification

In order to use web services API you need to activate web services in the settings of the organization. After enabling web services, you'll be given a unique identification and authentication token for the database of the organization.

For every API request you send, you'll need the following:

 • username for the API account that will be using web services
 • API secret key used as API password for API account
 • the API token of the organization

API user accounts can be created in the API Web services settings located in in the Company settings of your organization.

API request examples

API requests can be sent using HTTPS requests with either JSON or XML syntax as shown in the examples below. Please note that the URL of the API endpoint for your organization can be different than in the example below. Refer to live API test console to get the correct API endpoint URL for your organization.

JSON request

  
POST /WebServices/API HTTP/1.1
Host: eurofaktura.com
Content-Type: application/json

{
        "username": "john",
        "secretKey": "8b29582ce0a1e85da0c574d218acb900",
        "token": "341026F063054A129569212F3C9D01C6",
        "method": "SalesInvoiceGet",
        "parameters": {
                "number": "2022-00001",
                "date": "2025-11-15"
        }
}

XML request

  
POST /WebServices/API HTTP/1.1
Host: eurofaktura.com
Content-Type: application/octet-stream

<?xml version="1.0" encoding="utf-8"?>
<request>
        <login username="john" secretKey="8b29582ce0a1e85da0c574d218acb900" token="341026F063054A129569212F3C9D01C6" />
        <method name="SalesInvoiceGet">
                <parameter name="number" value="2022-00001" />
                <parameter name="date" value="2025-11-15" />
        </method>
</request>


×  
API user account is limited to the same functionality which is available in the normal GUI login with the same user privileges.
×  
Default rate limit for API Web services is a maximum of 1 request per second (on average) per each API user account. A burst of 4 consequtive requests is allowed followed by a pause until the 4 seconds period expires. Concurrent API requests by a single API user account are not allowed. Before sending another request you have to wait until the previous API request is finished. If you need to send requests concurrently you will need to create additional API user accounts to allocate the needed request pool and implement request pooling with a request queue on the client side according to your needs.
Request:
Parameters
JSON
XML
CURL
PHP
Python
Run   
Copy   
Response:
Download