Get a Bid
curl --request GET \
--url https://api.zivio.net/api/v4/bids/{id} \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/bids/{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/bids/{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/bids/{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/bids/{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/bids/{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/bids/{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,
"rate": {
"cents": 150000,
"currency": "GBP"
},
"fee": "1500.00",
"proposal": "Example proposal",
"supplier": {
"id": 101,
"name": "Acme Corporation",
"email": "user1@example.com",
"vetting_status": "PASSED",
"tax_number": "Example tax_number",
"tax_registered": true
},
"user": {
"id": 101,
"first_name": "Demo",
"last_name": "User",
"email": "user1@example.com",
"org_id": 501,
"org_name": "Acme Corporation"
},
"version": 101,
"status": "submitted",
"managed_bid": true,
"bafo": true,
"submitted_at": "2024-01-16T10:30:00+00:00",
"read_at": "2024-01-16T10:30:00+00:00",
"shortlisted_at": "2024-01-16T10:30:00+00:00",
"selected_at": "2024-01-16T10:30:00+00:00",
"hours": 101,
"eliminated": true,
"hired": true,
"total_score": "1500.00",
"quality_score": "1500.00",
"cost_score_auto": "1500.00",
"cost_score_override": "1500.00",
"source": "Example source",
"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": {
"id": 101,
"title": "Website Redesign Project",
"description": "Complete redesign of corporate website with modern UX"
},
"bid_milestones": [
{
"id": 101,
"bid_id": 501,
"title": "Website Redesign Project",
"details": "Additional information and context for this record.",
"rate": {
"cents": 150000,
"currency": "GBP"
},
"due_on": "2024-01-16",
"mandatory": false,
"client_suggested": false,
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00"
},
{
"id": 102,
"bid_id": 502,
"title": "Mobile App Development",
"details": "Additional information and context for this record.",
"rate": {
"cents": 300000,
"currency": "GBP"
},
"due_on": "2024-01-17",
"mandatory": false,
"client_suggested": false,
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00"
}
],
"line_item_proposals": [
{
"id": 101,
"item_type": "service",
"name": "Acme Corporation",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"quantity": "1500.00",
"price": {
"cents": 150000,
"currency": "GBP"
},
"uom": {
"id": 101,
"name": "Acme Corporation",
"code": "Example code",
"active": true
},
"net_total_price": null,
"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_line_item": {
"id": 101,
"name": "Acme Corporation",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"uom": null,
"item": null,
"item_type": "service",
"price": {
"cents": 150000,
"currency": "GBP"
},
"quantity": "1500.00",
"net_total_price": null,
"quantity_delivered": null,
"quantity_undelivered": null,
"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_id": 501
}
},
{
"id": 102,
"item_type": "item",
"name": "Global Services Ltd",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"quantity": "1500.00",
"price": {
"cents": 300000,
"currency": "GBP"
},
"uom": {
"id": 102,
"name": "Global Services Ltd",
"code": "Example code",
"active": true
},
"net_total_price": null,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"project_line_item": {
"id": 102,
"name": "Global Services Ltd",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"uom": null,
"item": null,
"item_type": "item",
"price": {
"cents": 300000,
"currency": "GBP"
},
"quantity": "1500.00",
"net_total_price": null,
"quantity_delivered": null,
"quantity_undelivered": null,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"project_id": 502
}
}
]
}Bids
Get a Bid
GET
/
bids
/
{id}
Get a Bid
curl --request GET \
--url https://api.zivio.net/api/v4/bids/{id} \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/bids/{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/bids/{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/bids/{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/bids/{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/bids/{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/bids/{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,
"rate": {
"cents": 150000,
"currency": "GBP"
},
"fee": "1500.00",
"proposal": "Example proposal",
"supplier": {
"id": 101,
"name": "Acme Corporation",
"email": "user1@example.com",
"vetting_status": "PASSED",
"tax_number": "Example tax_number",
"tax_registered": true
},
"user": {
"id": 101,
"first_name": "Demo",
"last_name": "User",
"email": "user1@example.com",
"org_id": 501,
"org_name": "Acme Corporation"
},
"version": 101,
"status": "submitted",
"managed_bid": true,
"bafo": true,
"submitted_at": "2024-01-16T10:30:00+00:00",
"read_at": "2024-01-16T10:30:00+00:00",
"shortlisted_at": "2024-01-16T10:30:00+00:00",
"selected_at": "2024-01-16T10:30:00+00:00",
"hours": 101,
"eliminated": true,
"hired": true,
"total_score": "1500.00",
"quality_score": "1500.00",
"cost_score_auto": "1500.00",
"cost_score_override": "1500.00",
"source": "Example source",
"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": {
"id": 101,
"title": "Website Redesign Project",
"description": "Complete redesign of corporate website with modern UX"
},
"bid_milestones": [
{
"id": 101,
"bid_id": 501,
"title": "Website Redesign Project",
"details": "Additional information and context for this record.",
"rate": {
"cents": 150000,
"currency": "GBP"
},
"due_on": "2024-01-16",
"mandatory": false,
"client_suggested": false,
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00"
},
{
"id": 102,
"bid_id": 502,
"title": "Mobile App Development",
"details": "Additional information and context for this record.",
"rate": {
"cents": 300000,
"currency": "GBP"
},
"due_on": "2024-01-17",
"mandatory": false,
"client_suggested": false,
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00"
}
],
"line_item_proposals": [
{
"id": 101,
"item_type": "service",
"name": "Acme Corporation",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"quantity": "1500.00",
"price": {
"cents": 150000,
"currency": "GBP"
},
"uom": {
"id": 101,
"name": "Acme Corporation",
"code": "Example code",
"active": true
},
"net_total_price": null,
"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_line_item": {
"id": 101,
"name": "Acme Corporation",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"uom": null,
"item": null,
"item_type": "service",
"price": {
"cents": 150000,
"currency": "GBP"
},
"quantity": "1500.00",
"net_total_price": null,
"quantity_delivered": null,
"quantity_undelivered": null,
"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_id": 501
}
},
{
"id": 102,
"item_type": "item",
"name": "Global Services Ltd",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"quantity": "1500.00",
"price": {
"cents": 300000,
"currency": "GBP"
},
"uom": {
"id": 102,
"name": "Global Services Ltd",
"code": "Example code",
"active": true
},
"net_total_price": null,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"project_line_item": {
"id": 102,
"name": "Global Services Ltd",
"manufacturer_name": "Example manufacturer_name",
"manufacturer_part_number": "Example manufacturer_part_number",
"uom": null,
"item": null,
"item_type": "item",
"price": {
"cents": 300000,
"currency": "GBP"
},
"quantity": "1500.00",
"net_total_price": null,
"quantity_delivered": null,
"quantity_undelivered": null,
"custom_fields": {
"department": "Engineering",
"priority": "high",
"cost_code": "CC-001"
},
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"project_id": 502
}
}
]
}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
Bid ID
Response
Bid details
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Available options:
draft, submitted, superseded, withdrawn Example:
"draft"
Example:
true
Example:
true
Example:
true
Example:
true
Key-value pairs of custom field data
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes