# Evidencia referencií

> Referencie a hodnotenia firmy z realizovaných verejných zákaziek vedené Úradom pre verejné obstarávanie. Dostupné podľa IČO cez REST API.

Po ukončení verejnej zákazky vystavuje obstarávateľ dodávateľovi referenciu s hodnotením. Evidencia referencií je tak jediný verejný zdroj, kde je kvalita plnenia slovenskej firmy zaznamenaná treťou stranou.

## Čo register obsahuje
- Počet referencií a ich celková hodnota
- Obstarávateľ, ktorý referenciu vystavil
- Predmet zákazky a hodnotenie
- Odkaz na dokument referencie

## Polia, ktoré vraciame

| Pole | Význam |
| --- | --- |
| `count` | Počet referencií k subjektu. |
| `total_value` | Celková hodnota zákaziek, ku ktorým boli referencie vystavené. |
| `currency` | Mena, v ktorej je hodnota uvedená. |
| `buyer_name` | Obstarávateľ, ktorý referenciu vystavil. |
| `contract_subject` | Predmet zákazky. |
| `rating` | Hodnotenie podľa referencie. |
| `published_at` | Dátum zverejnenia referencie. |
| `document_url` | Odkaz na dokument referencie. |

## Ako si dáta vyžiadate

```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"
      }
    ]
  }
}
```

## Ako často aktualizujeme

Denne. Referencie pribúdajú po ukončení jednotlivých zákaziek, takže register kontrolujeme každý deň.

## Na čo sa to používa

Referencia od verejného obstarávateľa je overiteľné hodnotenie, nie marketingové vyhlásenie. Pri výbere dodávateľa má inú váhu než odporúčanie na jeho webe.

Absencia referencií pri firme, ktorá vysúťažila zákazky, môže znamenať, že zákazky ešte nie sú ukončené – nie nutne, že plnenie bolo problémové.

## Časté otázky

### Koľko referencií vraciate?

Súhrnný počet a hodnotu plus 25 najnovších referencií s odkazom na dokument. Celý zoznam je dostupný v pôvodnom registri.

### Je hodnotenie porovnateľné medzi zákazkami?

Iba obmedzene – obstarávatelia hodnotia rôzne prísne. Referencie preto vraciame ako záznamy s odkazom na dokument a nespriemerujeme ich do jedného čísla.