Get a Supplier
curl --request GET \
--url https://api.zivio.net/api/v4/suppliers/{id} \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/suppliers/{id}"
headers = {
"Authorization": "Bearer <token>",
"zivio-tenant-id": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Bearer <token>', 'zivio-tenant-id': '<api-key>'}
};
fetch('https://api.zivio.net/api/v4/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://api.zivio.net/api/v4/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>",
"zivio-tenant-id: <api-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.zivio.net/api/v4/suppliers/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("zivio-tenant-id", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zivio.net/api/v4/suppliers/{id}")
.header("Authorization", "Bearer <token>")
.header("zivio-tenant-id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zivio.net/api/v4/suppliers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["zivio-tenant-id"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 101,
"name": "Acme Corporation",
"description": "Complete redesign of corporate website with modern UX",
"headline": "Example headline",
"tax_number": "Example tax_number",
"tax_registered": true,
"tax_jurisdiction": "Example tax_jurisdiction",
"duns_number": "Example duns_number",
"utr": "Example utr",
"ni_number": "Example ni_number",
"company_registration_number": "Example company_registration_number",
"website": "Example website",
"display_location": "Example display_location",
"display_location_country_code": "Example display_location_country_code",
"vetting_status": "PASSED",
"uuid": "Example uuid",
"onboarding_template_id": 501,
"linkedin_url": "Example linkedin_url",
"cis_contractor": null,
"cis_rate": {
"id": 101,
"label": "Example label",
"country_code": "Example country_code",
"rate": "1500.00",
"domestic_recharge": true,
"tax_reference": 101,
"archived": true,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00"
},
"payment_terms_in_days": 30,
"primary_address": null,
"invoice_address": null,
"onboarding_template_name": null,
"admin_custom_fields": null,
"accreditations": null,
"skills": null,
"supplier_risk_factors": null,
"badges": [
"urgent",
"featured"
],
"invited_by": {
"id": 101,
"first_name": "Demo",
"last_name": "User",
"email": "user1@example.com",
"org_id": 501,
"org_name": "Acme Corporation"
},
"archived_at": "2024-01-16T10:30:00+00:00",
"archived_reason": "Example archived_reason",
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00",
"project_matches_count": 5
}Suppliers
Get a Supplier
GET
/
suppliers
/
{id}
Get a Supplier
curl --request GET \
--url https://api.zivio.net/api/v4/suppliers/{id} \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/suppliers/{id}"
headers = {
"Authorization": "Bearer <token>",
"zivio-tenant-id": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {Authorization: 'Bearer <token>', 'zivio-tenant-id': '<api-key>'}
};
fetch('https://api.zivio.net/api/v4/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://api.zivio.net/api/v4/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>",
"zivio-tenant-id: <api-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.zivio.net/api/v4/suppliers/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("zivio-tenant-id", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.zivio.net/api/v4/suppliers/{id}")
.header("Authorization", "Bearer <token>")
.header("zivio-tenant-id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zivio.net/api/v4/suppliers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["zivio-tenant-id"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 101,
"name": "Acme Corporation",
"description": "Complete redesign of corporate website with modern UX",
"headline": "Example headline",
"tax_number": "Example tax_number",
"tax_registered": true,
"tax_jurisdiction": "Example tax_jurisdiction",
"duns_number": "Example duns_number",
"utr": "Example utr",
"ni_number": "Example ni_number",
"company_registration_number": "Example company_registration_number",
"website": "Example website",
"display_location": "Example display_location",
"display_location_country_code": "Example display_location_country_code",
"vetting_status": "PASSED",
"uuid": "Example uuid",
"onboarding_template_id": 501,
"linkedin_url": "Example linkedin_url",
"cis_contractor": null,
"cis_rate": {
"id": 101,
"label": "Example label",
"country_code": "Example country_code",
"rate": "1500.00",
"domestic_recharge": true,
"tax_reference": 101,
"archived": true,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00"
},
"payment_terms_in_days": 30,
"primary_address": null,
"invoice_address": null,
"onboarding_template_name": null,
"admin_custom_fields": null,
"accreditations": null,
"skills": null,
"supplier_risk_factors": null,
"badges": [
"urgent",
"featured"
],
"invited_by": {
"id": 101,
"first_name": "Demo",
"last_name": "User",
"email": "user1@example.com",
"org_id": 501,
"org_name": "Acme Corporation"
},
"archived_at": "2024-01-16T10:30:00+00:00",
"archived_reason": "Example archived_reason",
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00",
"project_matches_count": 5
}Authorizations
OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.
Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.
Path Parameters
Supplier ID
Response
Supplier details
Example:
true
Available options:
NOT REGISTERED, PASSED, FAILED, PENDING Example:
"NOT REGISTERED"
Example:
true
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Key-value pairs of custom field data
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Key-value pairs of custom field data
Show child attributes
Show child attributes

