# Supplier references

> References and ratings issued to a company for completed public contracts, maintained by the Slovak Public Procurement Office. Available by company ID through a REST API.

When a public contract is completed the contracting authority issues the supplier a reference with a rating. The reference register is therefore the only public source where the delivery quality of a Slovak company is recorded by a third party.

## What the register contains
- Number of references and their total value
- The contracting authority that issued the reference
- Contract subject and rating
- Link to the reference document

## Fields we return

| Field | Meaning |
| --- | --- |
| `count` | Number of references for the entity. |
| `total_value` | Total value of the contracts the references were issued for. |
| `currency` | Currency the value is stated in. |
| `buyer_name` | The contracting authority that issued the reference. |
| `contract_subject` | Subject of the contract. |
| `rating` | Rating recorded in the reference. |
| `published_at` | Date the reference was published. |
| `document_url` | Link to the reference document. |

## How to request the data

```http
GET /v1/company/ico/51636549?scope=uvo_references

{
  "uvo_references": {
    "count": 3,
    "total_value": 96400.0,
    "currency": "EUR",
    "latest": [
      {
        "buyer_name": "...",
        "contract_subject": "...",
        "rating": "...",
        "published_at": "2026-02-09"
      }
    ]
  }
}
```

## How often we update

Daily. References appear as individual contracts complete, so we check the register every day.

## What it is used for

A reference from a contracting authority is a verifiable rating, not a marketing claim. In supplier selection it carries different weight from a testimonial on the company website.

A lack of references for a company that has won contracts may simply mean those contracts are not finished yet – not necessarily that delivery was problematic.

## Frequently asked questions

### How many references do you return?

A summary count and value plus the 25 most recent references with a link to the document. The full list is available in the original register.

### Are ratings comparable across contracts?

Only to a degree – contracting authorities rate with differing severity. We therefore return references as records with a document link rather than averaging them into one number.