Get started with Conta’s API

Conta is a web based accounting system encompassing a number of services, including invoicing, accounting, and more. Through our API, other systems can interact with these features.

Each API key is linked to a user in Conta, with the same access level as that user. This means that the key can access the same services, organizations and data as the user who created it, where external routes are available.

Free sandbox environment

Our sandbox development environment is available free of charge. The sandbox environment is not capable of sending emails, so you can safely use it to test your integrations.

The free sandbox environment is available at:
https://app.conta-sandbox.no

To gain access to the sandbox environment:

• Register an account for free on the sandbox website by clicking the link above.
• Email customer support at [email protected] to request your email verification link so you can validate your account and enable your access to the sandbox environment.

While the sandbox is environment is free to use, please note that usage of our production environment, even for development purposes, requires an active subscription.

Getting started with Conta’s API gateway

1. Create a Conta Subscription
An active subscription to Conta’s services is required in order to use the API gateway. Access to individual features may depend on the chosen subscription plan. Certain API features may be unavailable if the chosen subscription does not include access to them.

2. Create an API key
Access to the API gateway is granted via API keys. The API key needs to be sent with each API call as an HTTP header: ‘conta-api-gateway-key’.

API keys can be created in the Conta app under Settings -> User account -> Manage API keys (Administrer API-nøkler)

3. Environments

Base URLs:

Production: https://api.gateway.conta.no
Sandbox: https://api.gateway.conta-staging.no

4. Review the API documentation 
Please review our Swagger API documentation here:

Production: http://docs.gateway.conta.no
Sandbox: http://docs.gateway.conta-sandbox.no

5. Organization access level

The API keys will have the same level of access to the system as the user creating the key. One user can have access to multiple organizations (businesses/virksomheter) in the system, so it is required to specify the organization id in the URL for most of the APIs.

Example URL: GET /organizations/11/customers

6. Simple example

To call an API, use the base path of the environment (see Environments above) + the relative route of the API you are going to call. Here is a simple CURL request to get information about a customer with id=123 from the organization with id=11:

Example Request:
curl -X GET -H ‘apiKey: 321dsasa03921FDfda#8123945’
https://api.gateway.conta.no/invoice/organizations/11/customers/123

Example Response:
{
  «id»: 123,
  «contacts»: [],
  «name»: «Ola Normann»,
  «customerType»: «INDIVIDUAL»,
  «dateOfBirth»: «1960-05-05»,
  «customerAddressLine1»: «FarAwayStreet 192H»,
  «customerAddressLine2»: «FarAwayCounty»,
  «customerAddressPostcode»: «0450»,
  «customerAddressCity»: «Oslo»,
  «customerAddressCountry»: «Norway»,
  «vismaNo»: 10001,
  «invoiceDeliveryMethod»: «EMAIL»,
  «isActive»: true
}