curl --request GET \
--url https://thirdparty.qonto.com/v2/suppliers/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://thirdparty.qonto.com/v2/suppliers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://thirdparty.qonto.com/v2/suppliers/{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://thirdparty.qonto.com/v2/suppliers/{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: Bearer <token>"
],
]);
$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://thirdparty.qonto.com/v2/suppliers/{id}"
req, _ := http.NewRequest("GET", url, nil)
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.get("https://thirdparty.qonto.com/v2/suppliers/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/suppliers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "018f4e5a-9c1d-7b2e-8a3f-1d2c3b4a5f60",
"organization_id": "018f4e5a-1111-7b2e-8a3f-1d2c3b4a5f60",
"name": "ACME SAS",
"status": "unarchived",
"currency": "EUR",
"default_vat_rate": 20,
"outstanding_balance": {
"value": "22.10",
"currency": "EUR"
},
"tax_identifiers": {
"vat_number": "FR12345678901",
"tin_number": "123456789"
},
"address": {
"street_address": "1 rue de la Paix",
"zip_code": "75002",
"province_code": "IDF",
"city": "Paris",
"country_code": "FR"
},
"contact_info": {
"email": "billing@acme.test",
"phone_number": "+33102030405"
},
"e_invoicing": {
"recipient_code": "ABC1234"
},
"payment_details": {
"iban": "FR7630006000011234567890189"
},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-16T14:05:00Z"
}Retrieve a supplier
Retrieves the supplier identified by the id path parameter.
curl --request GET \
--url https://thirdparty.qonto.com/v2/suppliers/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://thirdparty.qonto.com/v2/suppliers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://thirdparty.qonto.com/v2/suppliers/{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://thirdparty.qonto.com/v2/suppliers/{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: Bearer <token>"
],
]);
$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://thirdparty.qonto.com/v2/suppliers/{id}"
req, _ := http.NewRequest("GET", url, nil)
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.get("https://thirdparty.qonto.com/v2/suppliers/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://thirdparty.qonto.com/v2/suppliers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "018f4e5a-9c1d-7b2e-8a3f-1d2c3b4a5f60",
"organization_id": "018f4e5a-1111-7b2e-8a3f-1d2c3b4a5f60",
"name": "ACME SAS",
"status": "unarchived",
"currency": "EUR",
"default_vat_rate": 20,
"outstanding_balance": {
"value": "22.10",
"currency": "EUR"
},
"tax_identifiers": {
"vat_number": "FR12345678901",
"tin_number": "123456789"
},
"address": {
"street_address": "1 rue de la Paix",
"zip_code": "75002",
"province_code": "IDF",
"city": "Paris",
"country_code": "FR"
},
"contact_info": {
"email": "billing@acme.test",
"phone_number": "+33102030405"
},
"e_invoicing": {
"recipient_code": "ABC1234"
},
"payment_details": {
"iban": "FR7630006000011234567890189"
},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-16T14:05:00Z"
}Scope:
supplier_invoice.read
Sensitive fields (payment_details.iban, tax_identifiers) are masked unless the caller holds the permission to see sensitive supplier fields. outstanding_balance is only returned to callers with access to supplier invoice insights.Authorizations
Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Headers
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Path Parameters
"4d5418bb-bd0d-4df4-865c-c07afab8bb48"
Response
Returns the supplier identified by the id path parameter.
Unique identifier of the supplier.
"018f4e5a-9c1d-7b2e-8a3f-1d2c3b4a5f60"
Identifier of the organization the supplier belongs to.
"018f4e5a-1111-7b2e-8a3f-1d2c3b4a5f60"
Name of the supplier.
"ACME SAS"
Lifecycle status of the supplier. It cannot be changed through the create and update endpoints.
unarchived, archived, draft "unarchived"
Default currency of the supplier, as an ISO 4217 code.
"EUR"
Default VAT rate applied to the supplier's invoices, in percent.
20
Outstanding balance of the supplier. Only returned to callers with access to supplier invoice insights.
Show child attributes
Show child attributes
Tax identifiers of the supplier. Omitted from responses when empty.
Show child attributes
Show child attributes
Postal address of the supplier. Omitted from responses when empty.
Show child attributes
Show child attributes
Contact details of the supplier. Omitted from responses when empty.
Show child attributes
Show child attributes
E-invoicing details of the supplier. Omitted from responses when empty.
Show child attributes
Show child attributes
Payment details of the supplier. Omitted from responses when empty.
Show child attributes
Show child attributes
Date and time when the supplier was created.
"2026-01-15T09:30:00Z"
Date and time when the supplier was last updated.
"2026-01-16T14:05:00Z"
Was this page helpful?