Retrieve a Invoice

curl --request GET \
  --url https://api.nocotax.app/invoices/{id} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.nocotax.app/invoices/{id}', 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.nocotax.app/invoices/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$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.nocotax.app/invoices/{id}"

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

	req.Header.Add("Authorization", "Basic <encoded-value>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nocotax.app/invoices/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

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

{
  "id": "inv_1792060758f7rtea88ebab",
  "livemode": false,
  "object": "invoice",
  "amount_due": null,
  "amount_overpaid": null,
  "amount_paid": null,
  "amount_remaining": null,
  "automatic_tax_calculation": {
    "enabled": false
  },
  "currency": "EUR",
  "customer_data": {
    "name": "Ruecker LLC",
    "billing_address": {
      "city": "South Karatown",
      "line1": "2170 Rippin Crescent",
      "line2": "Apt. 176",
      "country": "BQ",
      "postal_code": "23942-4096"
    },
    "tax_identification_number": "348693185",
    "business_registration_number": "23142061300599"
  },
  "customer_id": "org_1792060758cxjw69043bfe",
  "customer_tax_registration_data": [],
  "customer_tax_registration_ids": [],
  "document_date": null,
  "document_number": null,
  "due_date": null,
  "flow": "sales",
  "issuer": null,
  "legal_notices": null,
  "locale": "en",
  "memo": null,
  "metadata": {},
  "numbering_sequence_id": "ns_1792060758clyq7904ff6f",
  "order_reference": null,
  "payment_status": null,
  "payment_terms": null,
  "period": null,
  "postpayment_credit_notes_amount": null,
  "prepayment_credit_notes_amount": null,
  "representations": {},
  "status": "draft",
  "status_transitions": {},
  "supplier_country": "BQ",
  "supplier_data": {
    "name": "McLaughlin, Monahan and Frami",
    "billing_address": {
      "city": "Lake Leon",
      "line1": "272 Damian Burgs",
      "line2": "Suite 336",
      "country": "BQ",
      "postal_code": "57717-0497"
    },
    "tax_identification_number": "174352302",
    "business_registration_number": "82130922600487"
  },
  "supplier_id": "org_1792060758ccooc5bfa8ac",
  "supplier_tax_registration_data": [],
  "supplier_tax_registration_ids": [],
  "taxes": [],
  "total_extratax_amount": 2888,
  "total_tax_amount": 0,
  "total_tax_included_amount": 2888,
  "created_at": "2026-10-15T10:39:18.715Z",
  "updated_at": "2026-10-15T10:39:18.715Z"
}

GET

invoices

{id}

Retrieve a Invoice

curl --request GET \
  --url https://api.nocotax.app/invoices/{id} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.nocotax.app/invoices/{id}', 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.nocotax.app/invoices/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$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.nocotax.app/invoices/{id}"

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

	req.Header.Add("Authorization", "Basic <encoded-value>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nocotax.app/invoices/{id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

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

{
  "id": "inv_1792060758f7rtea88ebab",
  "livemode": false,
  "object": "invoice",
  "amount_due": null,
  "amount_overpaid": null,
  "amount_paid": null,
  "amount_remaining": null,
  "automatic_tax_calculation": {
    "enabled": false
  },
  "currency": "EUR",
  "customer_data": {
    "name": "Ruecker LLC",
    "billing_address": {
      "city": "South Karatown",
      "line1": "2170 Rippin Crescent",
      "line2": "Apt. 176",
      "country": "BQ",
      "postal_code": "23942-4096"
    },
    "tax_identification_number": "348693185",
    "business_registration_number": "23142061300599"
  },
  "customer_id": "org_1792060758cxjw69043bfe",
  "customer_tax_registration_data": [],
  "customer_tax_registration_ids": [],
  "document_date": null,
  "document_number": null,
  "due_date": null,
  "flow": "sales",
  "issuer": null,
  "legal_notices": null,
  "locale": "en",
  "memo": null,
  "metadata": {},
  "numbering_sequence_id": "ns_1792060758clyq7904ff6f",
  "order_reference": null,
  "payment_status": null,
  "payment_terms": null,
  "period": null,
  "postpayment_credit_notes_amount": null,
  "prepayment_credit_notes_amount": null,
  "representations": {},
  "status": "draft",
  "status_transitions": {},
  "supplier_country": "BQ",
  "supplier_data": {
    "name": "McLaughlin, Monahan and Frami",
    "billing_address": {
      "city": "Lake Leon",
      "line1": "272 Damian Burgs",
      "line2": "Suite 336",
      "country": "BQ",
      "postal_code": "57717-0497"
    },
    "tax_identification_number": "174352302",
    "business_registration_number": "82130922600487"
  },
  "supplier_id": "org_1792060758ccooc5bfa8ac",
  "supplier_tax_registration_data": [],
  "supplier_tax_registration_ids": [],
  "taxes": [],
  "total_extratax_amount": 2888,
  "total_tax_amount": 0,
  "total_tax_included_amount": 2888,
  "created_at": "2026-10-15T10:39:18.715Z",
  "updated_at": "2026-10-15T10:39:18.715Z"
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

string

required

Response

200 - application/json

successful

string

livemode

boolean

object

string

amount_due

integer | null

The amount due at the time the invoice is finalized, in the currency's smaller unit (eg. cents)

amount_overpaid

integer | null

If the amount of transactions attached to this invoice exceed its final amount, the amount overpaid, in the currency's smaller unit (eg. cents)

amount_paid

integer | null

The amount that has been paid, in the currency's smaller unit (eg. cents)

amount_remaining

integer | null

The amount still due, in the currency's smaller unit (eg. cents)

automatic_tax_calculation

object

When automatic tax calculation is enabled, Nocotax automatically determines which tax rates must be applied to each item sold within the document.

Show child attributes

currency

string

The currency ISO code of the document

customer_data

object

Show child attributes

customer_id

string

The ID of the organization this document refers as a customer

customer_tax_registration_data

object[]

The customer’s tax registration data. They are displayed on the PDF of the document, and may be used for automatic tax calculation if enabled.

Show child attributes

customer_tax_registration_ids

string[]

The customer’s tax registration IDs.

document_date

string | null

The date of issuance of this document. Its value is null when the document status is draft

document_number

string | null

The number of this document. Its value is null when the document status is draft

due_date

string<date> | null

The date on which payment for this invoice is due

issuer

object | null

If the issuer of the document is not the supplier (in case of white-label or self billing), information on the issuer

Show child attributes

flow

enum<string>

Specifies the direction or role of the account owner in the invoicing transaction. sales: The account owner is the supplier (i.e., the entity issuing the document for goods or services provided). purchases: The account owner is the customer (i.e., the entity receiving the document for goods or services purchased). platform: The account owner is a facilitator (i.e., the entity enabling the transaction between a customer and a supplier, such as a marketplace or intermediary).

Available options:

sales,

purchases,

platform

legal_notices

string[] | null

A text representing a legal notice to display on document representations

locale

string

The locale used for this invoice representations (PDF)

memo

string | null

Document memo

numbering_sequence_id

string

The ID of the numbering sequence this document is using to generate its number at finalization

order_reference

string | null

payment_status

enum<string> | null

The status of the invoice payment. open: The invoice has not been paid, but the due date is in the future. due: A payment for the total or a part of this invoice is expected. paid: This invoice has been paid.

Available options:

open,

due,

paid

payment_terms

object | null

Payment terms for this invoice. Represent the number of days after finalization so the invoice is due. Do not provide along with due_date

Show child attributes

period

object | null

The period associated with this document. Used to recognize and defer revenue

Show child attributes

postpayment_credit_notes_amount

integer | null

Sum of amounts of all post-payment credit notes issued for this invoice

prepayment_credit_notes_amount

integer | null

Sum of amounts of all pre-payment credit notes issued for this invoice

representations

object

After finalization of a document, you can share its representations to whoever you want. This is a set of URLs you can share.

Show child attributes

status

enum<string>

The status of the document, one of draft, finalized, cancelled

Available options:

draft,

finalized,

cancelled

status_transitions

object

Show child attributes

supplier_country

string

The country (ISO alpha 2) of the country of issuance of the document

supplier_data

object

Show child attributes

supplier_id

string

The ID of the organization this document refers as a supplier

supplier_tax_registration_data

object[]

The supplier's tax registration data. They are displayed on the PDF of the document, and may be used for automatic tax calculation if enabled.

Show child attributes

supplier_tax_registration_ids

string[]

The customer’s tax registration IDs.

taxes

object[] | null

The document's tax breakdown

Show child attributes

total_extratax_amount

integer

Total extratax amount of the document, in the currency's smaller unit (eg. cents)

total_tax_amount

integer

Total tax amount of the document, in the currency's smaller unit (eg. cents)

total_tax_included_amount

integer

Total tax included of the document, in the currency's smaller unit (eg. cents)

created_at

string<date-time>

updated_at

string<date-time>

General usage

Core APIs

Recurring APIs

Invoicing APIs

Tax APIs

Retrieve a Invoice

Authorizations

Path Parameters

Response