Gratis webinarer fra Conta - Lær om regnskap, skatt og mye mer!

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.

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.

Conta has a developer sandbox environment available for use. The sandbox environment is not capable of sending emails, so you can safely use it to test your integration with invoicing and accounting functionality.

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

To gain access to the sandbox environment:

  • Register an account on the sandbox environment website with the link above.
  • Email Conta customer support to get validated and your access enabled: [email protected].

Get started with Conta’s API

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 depends on the chosen subscription plan. Some API features may be unavailable if the 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
}

Abonner på Conta sitt nyhetsbrev

Abonner på Conta nyhetsbrev

Abonner på nyhetsbrevet fra Conta og hold deg oppdatert på nye funksjoner, samt nyttige tips og triks.

Kun levere skattemelding / årsregnskap? Kom i gang med årsoppgjør i Conta!