Get an access token

curl --request POST \
  --url https://api.envoi.no/v1/oauth/token \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=client_credentials \
  --data audience=https://api.envoi.no/v1/accounts/P11112001

import requests

url = "https://api.envoi.no/v1/oauth/token"

payload = {
    "grant_type": "client_credentials",
    "audience": "https://api.envoi.no/v1/accounts/P11112001"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Basic <encoded-value>',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'client_credentials',
    audience: 'https://api.envoi.no/v1/accounts/P11112001'
  })
};

fetch('https://api.envoi.no/v1/oauth/token', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.envoi.no/v1/oauth/token",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.envoi.no/v1/oauth/token"

	payload := strings.NewReader("grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.envoi.no/v1/oauth/token")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.envoi.no/v1/oauth/token")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001"

response = http.request(request)
puts response.read_body

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzZjBjNmMyZSJ9.c2lnbmF0dXJl",
  "token_type": "Bearer",
  "expires_in": 900,
  "scope": "bilag:read clients:write invoices:write reports:read"
}

Authentication

Get an access token

OAuth 2.0 client credentials (RFC 6749 section 4.4). Send the Client ID and client secret with HTTP Basic (Authorization: Basic base64(client_id:client_secret), each part form-url-encoded first) or as client_id and client_secret in the form, not both. The body is always a form (application/x-www-form-urlencoded).

audience names the account: https://api.envoi.no/v1/accounts/P11112001 for production or https://api.envoi.no/v1/accounts/T11112001 for its Testmiljø. The client needs an active grant for that environment.

The token lives 15 minutes (expires_in). There is no refresh token: ask again with the same credentials. Errors use the OAuth shape { "error": "..." }.

curl https://api.envoi.no/v1/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d audience=https://api.envoi.no/v1/accounts/P11112001

POST

https://api.envoi.no

oauth

token

Get an access token

curl --request POST \
  --url https://api.envoi.no/v1/oauth/token \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=client_credentials \
  --data audience=https://api.envoi.no/v1/accounts/P11112001

import requests

url = "https://api.envoi.no/v1/oauth/token"

payload = {
    "grant_type": "client_credentials",
    "audience": "https://api.envoi.no/v1/accounts/P11112001"
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Basic <encoded-value>',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: new URLSearchParams({
    grant_type: 'client_credentials',
    audience: 'https://api.envoi.no/v1/accounts/P11112001'
  })
};

fetch('https://api.envoi.no/v1/oauth/token', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.envoi.no/v1/oauth/token",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/x-www-form-urlencoded"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.envoi.no/v1/oauth/token"

	payload := strings.NewReader("grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/x-www-form-urlencoded")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.envoi.no/v1/oauth/token")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .body("grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.envoi.no/v1/oauth/token")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/x-www-form-urlencoded'
request.body = "grant_type=client_credentials&audience=https%3A%2F%2Fapi.envoi.no%2Fv1%2Faccounts%2FP11112001"

response = http.request(request)
puts response.read_body

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzZjBjNmMyZSJ9.c2lnbmF0dXJl",
  "token_type": "Bearer",
  "expires_in": 900,
  "scope": "bilag:read clients:write invoices:write reports:read"
}

Authorizations

Authorization

string

header

required

For the token endpoint only: the Client ID and client secret as HTTP Basic (each part form-url-encoded first, RFC 6749 section 2.3.1).

Body

application/x-www-form-urlencoded

The form the token endpoint reads (application/x-www-form-urlencoded).

grant_type

string

required

Always client_credentials.

audience

string

required

The account the token is for: https://api.envoi.no/v1/accounts/{accountId}. The Account ID's prefix picks the environment: P is production, T is the Testmiljø.

client_id

string | null

The Client ID, when the credentials are not sent with HTTP Basic.

client_secret

string | null

The client secret, when the credentials are not sent with HTTP Basic. Refused next to an HTTP Basic header.

Response

The access token.

An access token.

access_token

string

required

The bearer token. Send it as Authorization: Bearer {access_token}.

token_type

string

required

Always Bearer.

expires_in

integer<int32>

required

Seconds until the token expires (900, 15 minutes). There is no refresh token: ask for a new one with the same credentials.

scope

string

required

The grant's scopes, space separated.

Get started

Authentication

Invoices

Customers

Accounting

Get an access token

Authorizations

Body

Response