Send an invoice

curl --request POST \
  --url https://api.envoi.no/v1/invoices/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'

import requests

url = "https://api.envoi.no/v1/invoices/{id}/send"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.envoi.no/v1/invoices/{id}/send', 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/invoices/{id}/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.envoi.no/v1/invoices/{id}/send"

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")

	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/invoices/{id}/send")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.envoi.no/v1/invoices/{id}/send")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "8b6f2a4e-1c3d-4e5f-9a7b-2c4d6e8f0a12",
  "number": "10023",
  "type": "invoice",
  "status": "sent",
  "kid": "000100231",
  "issueDate": "2026-09-29",
  "dueDate": "2026-10-13",
  "paidAt": null,
  "reference": "Ordre 5512",
  "notes": "Takk for handelen!",
  "client": {
    "id": "c2a9d4e1-5b7f-4c3a-8e6d-1f2a3b4c5d6e",
    "name": "Fjordkaffe AS",
    "email": "post@fjordkaffe.no",
    "address": "Kaigata 1",
    "postalCode": "5003",
    "city": "Bergen",
    "orgNumber": "912345688",
    "country": "NO",
    "vatNumber": null
  },
  "currency": "NOK",
  "subtotal": 1000,
  "vat": 250,
  "total": 1250,
  "paidAmount": 0,
  "outstandingAmount": 1250,
  "creditedAmount": 0,
  "lines": [
    {
      "description": "Kaffebønner 1 kg",
      "quantity": 4,
      "unitPrice": 250,
      "vatRate": 25,
      "vatCode": 3,
      "lineTotal": 1000,
      "vatAmount": 250
    }
  ],
  "payments": [],
  "createdAt": "2026-09-29T10:15:00Z",
  "updatedAt": "2026-09-29T10:15:00Z"
}

POST

https://api.envoi.no

invoices

{id}

send

Send an invoice

curl --request POST \
  --url https://api.envoi.no/v1/invoices/{id}/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>'

import requests

url = "https://api.envoi.no/v1/invoices/{id}/send"

headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};

fetch('https://api.envoi.no/v1/invoices/{id}/send', 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/invoices/{id}/send",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.envoi.no/v1/invoices/{id}/send"

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")

	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/invoices/{id}/send")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.envoi.no/v1/invoices/{id}/send")

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

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'

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

{
  "id": "8b6f2a4e-1c3d-4e5f-9a7b-2c4d6e8f0a12",
  "number": "10023",
  "type": "invoice",
  "status": "sent",
  "kid": "000100231",
  "issueDate": "2026-09-29",
  "dueDate": "2026-10-13",
  "paidAt": null,
  "reference": "Ordre 5512",
  "notes": "Takk for handelen!",
  "client": {
    "id": "c2a9d4e1-5b7f-4c3a-8e6d-1f2a3b4c5d6e",
    "name": "Fjordkaffe AS",
    "email": "post@fjordkaffe.no",
    "address": "Kaigata 1",
    "postalCode": "5003",
    "city": "Bergen",
    "orgNumber": "912345688",
    "country": "NO",
    "vatNumber": null
  },
  "currency": "NOK",
  "subtotal": 1000,
  "vat": 250,
  "total": 1250,
  "paidAmount": 0,
  "outstandingAmount": 1250,
  "creditedAmount": 0,
  "lines": [
    {
      "description": "Kaffebønner 1 kg",
      "quantity": 4,
      "unitPrice": 250,
      "vatRate": 25,
      "vatCode": 3,
      "lineTotal": 1000,
      "vatAmount": 250
    }
  ],
  "payments": [],
  "createdAt": "2026-09-29T10:15:00Z",
  "updatedAt": "2026-09-29T10:15:00Z"
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. The token request also needs the audience form field (the Account ID), which OAuth tooling does not always send; see POST /v1/oauth/token.

Headers

Idempotency-Key

string

required

Required on every POST, at most 255 characters. Use a new UUID for each logical operation. The first request with a key runs, and its answer (any status below 500) is stored for 7 days. A retry with the same key, method, path and body gets the stored answer again with Idempotency-Replayed: true, and nothing runs twice. The same key with a different body or path is 422 idempotency-key-reused; the same key while the first request is still running is 409 idempotency-key-in-progress. A 5xx answer is not stored, so the same key may be retried. A key belongs to the API client's grant (one environment).

Maximum string length: 255

Path Parameters

string<uuid>

required

The draft invoice's id.

Response

The sent invoice.

An invoice or credit note.

string<uuid>

required

The invoice's id.

type

string

required

invoice or credit_note.

status

string

required

draft, sent, viewed, paid, overdue, reminded, collection_warning, credited or bounced.

issueDate

string<date>

required

The invoice date.

dueDate

string<date>

required

The due date.

reference

string

required

Your reference, for example an order number; empty when none.

client

object

required

The client on an invoice: the name and address the invoice is made out to.

Show child attributes

currency

string

required

Always NOK in v1.

subtotal

number

required

Total without VAT.

vat

number

required

Total VAT.

total

number

required

Total with VAT.

paidAmount

number

required

How much has been paid.

outstandingAmount

number

required

How much is still owed.

lines

object[]

required

The invoice lines.

Show child attributes

payments

object[]

required

The payments recorded on it.

Show child attributes

createdAt

string<date-time>

required

When it was created (UTC).

updatedAt

string<date-time>

required

When it last changed (UTC).

creditedAmount

number

required

The issued credit notes against the invoice; outstandingAmount is net of it.

number

string | null

The invoice number, or null on a draft (it gets one when it is sent).

kid

string | null

The KID (payment reference), or null when there is none (always on a draft).

paidAt

string<date> | null

The date it was paid in full, or null.

notes

string | null

A note printed on the invoice, or null.

Get started

Authentication

Invoices

Customers

Accounting

Send an invoice

Authorizations

Headers

Path Parameters

Response