List Raw Scorecard Entries
curl --request GET \
--url https://api.zivio.net/api/v4/raw_scorecard_entries \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/raw_scorecard_entries"
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/raw_scorecard_entries', 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/raw_scorecard_entries",
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/raw_scorecard_entries"
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/raw_scorecard_entries")
.header("Authorization", "Bearer <token>")
.header("zivio-tenant-id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zivio.net/api/v4/raw_scorecard_entries")
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{
"raw_scorecard_entries": [
{
"id": 101,
"supplier_id": 501,
"supplier_external_id": 501,
"provider": "Example provider",
"dimension": "Example dimension",
"ccy": "GBP",
"external_id": "EXT-1001",
"bids_total_count": 101,
"milestones_completed": 101,
"milestones_total_count": 101,
"milestones_on_time_count": 101,
"milestones_on_budget_count": 101,
"milestones_total_cents": 101,
"milestones_approved_cents": 101,
"milestones_committed_cents": 101,
"max_ended_at": "2024-01-16T10:30:00+00:00",
"days_late_total": 101,
"variation_orders_accepted_count": 101,
"invoices_approved_cents": 101,
"rating": "1500.00",
"rating_count": 101,
"universe_overall_rating_total": "1500.00",
"supplier_reviews_count": 101,
"all_reviews_count": 101,
"all_distinct_reviews_count": 101,
"recommended_reviews_count": 101,
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00",
"projects_completed": null,
"projects_in_progress": null,
"projects_won_count": null,
"projects_budgetable_count": null,
"projects_on_time_count": null,
"projects_on_budget_count": null,
"projects_budget_total_cents": null,
"projects_original_budget_total_cents": null
},
{
"id": 102,
"supplier_id": 502,
"supplier_external_id": 502,
"provider": "Example provider",
"dimension": "Example dimension",
"ccy": "GBP",
"external_id": "EXT-1002",
"bids_total_count": 102,
"milestones_completed": 102,
"milestones_total_count": 102,
"milestones_on_time_count": 102,
"milestones_on_budget_count": 102,
"milestones_total_cents": 102,
"milestones_approved_cents": 102,
"milestones_committed_cents": 102,
"max_ended_at": "2024-01-17T10:30:00+00:00",
"days_late_total": 102,
"variation_orders_accepted_count": 102,
"invoices_approved_cents": 102,
"rating": "1500.00",
"rating_count": 102,
"universe_overall_rating_total": "1500.00",
"supplier_reviews_count": 102,
"all_reviews_count": 102,
"all_distinct_reviews_count": 102,
"recommended_reviews_count": 102,
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"projects_completed": null,
"projects_in_progress": null,
"projects_won_count": null,
"projects_budgetable_count": null,
"projects_on_time_count": null,
"projects_on_budget_count": null,
"projects_budget_total_cents": null,
"projects_original_budget_total_cents": null
}
]
}Raw Scorecard Entries
List Raw Scorecard Entries
Retrieve a paginated list of raw_scorecard_entries. Use filters to narrow results.
Filtering
Use the filter[<attribute>] parameter to filter results. Multiple filters are combined with AND logic.
Basic Examples
# Equality (implicit)
GET /api/v4/raw_scorecard_entries?filter[provider]=active
# Multiple values (implicit IN)
GET /api/v4/raw_scorecard_entries?filter[provider]=draft,pending
# With explicit operator
GET /api/v4/raw_scorecard_entries?filter[created_at][gte]=2024-01-01
# Range query
GET /api/v4/raw_scorecard_entries?filter[milestones_total][between]=1000000,5000000
# Multiple filters (AND)
GET /api/v4/raw_scorecard_entries?filter[provider]=active&filter[milestones_total][gte]=1000000
Available Attributes
| Attribute | Type | Operators | Permitted Values |
|---|---|---|---|
| all_distinct_reviews_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| all_reviews_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| bids_total_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| ccy | string | eq, not_eq, in, not_in, like, not_like | - |
| created_at | datetime | eq, not_eq, gt, gte, lt, lte, between | - |
| days_late_total | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| dimension | string | eq, not_eq, in, not_in, like, not_like | - |
| external_id | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| id | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| invoices_approved | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| max_ended_at | datetime | eq, not_eq, gt, gte, lt, lte, between | - |
| milestones_approved | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_committed | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_completed | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_on_budget_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_on_time_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_total | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| milestones_total_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_budget_total | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_budgetable_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_completed | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_in_progress | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_on_budget_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_on_time_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_original_budget_total | money | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| projects_won_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| provider | string | eq, not_eq, in, not_in, like, not_like | - |
| rating | decimal | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| rating_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| recommended_reviews_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| supplier_id | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| supplier_reviews_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| universe_overall_rating_total | decimal | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
| updated_at | datetime | eq, not_eq, gt, gte, lt, lte, between | - |
| variation_orders_accepted_count | integer | eq, not_eq, in, not_in, gt, gte, lt, lte, between | - |
OR Conditions
Use or[group] to combine filter groups with OR logic. Filters within a group are ANDed:
# Simple OR
GET /api/v4/raw_scorecard_entries?or[1][provider]=pending&or[2][provider]=active
# Complex OR (provider=pending AND milestones_total>=1000000) OR (provider=active)
GET /api/v4/raw_scorecard_entries?or[1][provider]=pending&or[1][milestones_total][gte]=1000000&or[2][provider]=active
Sorting
Use sort[<attribute>] to order results. Default direction is ascending.
# Ascending (implicit)
GET /api/v4/raw_scorecard_entries?sort[created_at]=
# Descending
GET /api/v4/raw_scorecard_entries?sort[created_at]=desc
# Combined with filters
GET /api/v4/raw_scorecard_entries?filter[provider]=active&sort[created_at]=desc
GET
/
raw_scorecard_entries
List Raw Scorecard Entries
curl --request GET \
--url https://api.zivio.net/api/v4/raw_scorecard_entries \
--header 'Authorization: Bearer <token>' \
--header 'zivio-tenant-id: <api-key>'import requests
url = "https://api.zivio.net/api/v4/raw_scorecard_entries"
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/raw_scorecard_entries', 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/raw_scorecard_entries",
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/raw_scorecard_entries"
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/raw_scorecard_entries")
.header("Authorization", "Bearer <token>")
.header("zivio-tenant-id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zivio.net/api/v4/raw_scorecard_entries")
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{
"raw_scorecard_entries": [
{
"id": 101,
"supplier_id": 501,
"supplier_external_id": 501,
"provider": "Example provider",
"dimension": "Example dimension",
"ccy": "GBP",
"external_id": "EXT-1001",
"bids_total_count": 101,
"milestones_completed": 101,
"milestones_total_count": 101,
"milestones_on_time_count": 101,
"milestones_on_budget_count": 101,
"milestones_total_cents": 101,
"milestones_approved_cents": 101,
"milestones_committed_cents": 101,
"max_ended_at": "2024-01-16T10:30:00+00:00",
"days_late_total": 101,
"variation_orders_accepted_count": 101,
"invoices_approved_cents": 101,
"rating": "1500.00",
"rating_count": 101,
"universe_overall_rating_total": "1500.00",
"supplier_reviews_count": 101,
"all_reviews_count": 101,
"all_distinct_reviews_count": 101,
"recommended_reviews_count": 101,
"created_at": "2024-01-16T10:30:00+00:00",
"updated_at": "2024-01-16T10:30:00+00:00",
"projects_completed": null,
"projects_in_progress": null,
"projects_won_count": null,
"projects_budgetable_count": null,
"projects_on_time_count": null,
"projects_on_budget_count": null,
"projects_budget_total_cents": null,
"projects_original_budget_total_cents": null
},
{
"id": 102,
"supplier_id": 502,
"supplier_external_id": 502,
"provider": "Example provider",
"dimension": "Example dimension",
"ccy": "GBP",
"external_id": "EXT-1002",
"bids_total_count": 102,
"milestones_completed": 102,
"milestones_total_count": 102,
"milestones_on_time_count": 102,
"milestones_on_budget_count": 102,
"milestones_total_cents": 102,
"milestones_approved_cents": 102,
"milestones_committed_cents": 102,
"max_ended_at": "2024-01-17T10:30:00+00:00",
"days_late_total": 102,
"variation_orders_accepted_count": 102,
"invoices_approved_cents": 102,
"rating": "1500.00",
"rating_count": 102,
"universe_overall_rating_total": "1500.00",
"supplier_reviews_count": 102,
"all_reviews_count": 102,
"all_distinct_reviews_count": 102,
"recommended_reviews_count": 102,
"created_at": "2024-01-17T10:30:00+00:00",
"updated_at": "2024-01-17T10:30:00+00:00",
"projects_completed": null,
"projects_in_progress": null,
"projects_won_count": null,
"projects_budgetable_count": null,
"projects_on_time_count": null,
"projects_on_budget_count": null,
"projects_budget_total_cents": null,
"projects_original_budget_total_cents": null
}
]
}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.
Query Parameters
Page number for pagination
Number of results per page (max 100)
Required range:
x <= 100Filterable attributes:
integer (operators: eq, not_eq, in, not_in, gt, gte, lt, lte, between): all_distinct_reviews_count, all_reviews_count, bids_total_count, days_late_total, external_id, id, milestones_completed, milestones_on_budget_count, milestones_on_time_count, milestones_total_count, projects_budgetable_count, projects_completed, projects_in_progress, projects_on_budget_count, projects_on_time_count, projects_won_count, rating_count, recommended_reviews_count, supplier_id, supplier_reviews_count, variation_orders_accepted_count datetime (operators: eq, not_eq, gt, gte, lt, lte, between): created_at, max_ended_at, updated_at money (operators: eq, not_eq, in, not_in, gt, gte, lt, lte, between): invoices_approved, milestones_approved, milestones_committed, milestones_total, projects_budget_total, projects_original_budget_total decimal (operators: eq, not_eq, in, not_in, gt, gte, lt, lte, between): rating, universe_overall_rating_total string (operators: eq, not_eq, in, not_in, like, not_like): ccy, dimension, provider
Note: money values are in minor currency units (e.g. pence for GBP). Use 1000000 for £10,000.00.
Note: like is a case-insensitive substring match — pass the bare term (filter[title][like]=redesign). Do not add % wildcards; they are not needed.
OR condition groups. Filters within a group are ANDed; groups are ORed.
Syntax: or[group_key][<attribute>]=value or or[group_key][<attribute>][operator]=value
Examples:
- Simple OR:
or[1][state]=draft&or[2][state]=pending - Complex:
or[1][state]=draft&or[1][budget][gte]=50000&or[2][state]=closed - With custom fields:
or[1][cf][priority]=high&or[2][state]=pending
Group keys can be any string (1, 2, a, b, etc.) - they just need to be unique.
Sort results by attribute. Direction defaults to ascending.
Syntax: sort[<attribute>]= (ascending) or sort[<attribute>]=desc (descending)
Sortable attributes: all_distinct_reviews_count, all_reviews_count, bids_total_count, ccy, created_at, days_late_total, dimension, external_id, id, invoices_approved, max_ended_at, milestones_approved, milestones_committed, milestones_completed, milestones_on_budget_count, milestones_on_time_count, milestones_total, milestones_total_count, projects_budget_total, projects_budgetable_count, projects_completed, projects_in_progress, projects_on_budget_count, projects_on_time_count, projects_original_budget_total, projects_won_count, provider, rating, rating_count, recommended_reviews_count, supplier_id, supplier_reviews_count, universe_overall_rating_total, updated_at, variation_orders_accepted_count
Examples:
- Ascending:
sort[created_at]=orsort[created_at]=asc - Descending:
sort[created_at]=desc
Response
List of raw_scorecard_entries
Show child attributes
Show child attributes