Firmo API juhend

Firmo andmed otse Sinu CRM-i, müügi- või krediidisüsteemi. API on Radar 3 ja Suurkliendi paketis ning avatakse pärast lepingu sõlmimist. Prooviperioodil API-t ei ole.

Alustamine

Logi sisse ja ava Konto, Firma.
Kaardil API sisesta oma serveri IP aadress ja vajuta Loo võti. Võti töötab ainult sellelt IP aadressilt ja on ainult Sinu firma kasutamiseks. Võtit näidatakse ainult üks kord, hoia seda turvaliselt.
Lisa võti iga päringu päisesse: Authorization: Bearer fk_... (või X-API-Key: fk_...).

curl -H "Authorization: Bearer fk_..." "https://firmo.ee/api/v1/domains?days=1&shop=1"

Vastus on JSON: {"ok": true, "data": ..., "usage": {"used": 12, "limit": 50000}}. Iga päring on üks ühik kuu limiidist. Kuni 10 päringut sekundis. Vea korral ok: false ja selgitus.

Päringud

`GET /api/v1/company?reg=12345678`

Ettevõtte andmed: rekvisiidid, kontaktid, reiting, maksuvõlg, aruanded, kvartalid, juhatus, osanikud.

`GET /api/v1/search?q=nimi`

Otsing nime, registrikoodi või telefoni järgi, kuni 20 vastet.

`GET /api/v1/domains?days=7`

Uued .ee domeenid ja e-poed koos firma, e-posti, telefoni, käibe ja reitinguga. Filtrid: days (1 kuni 60), shop=1 ainult e-poed, firm=1 ainult firmaga seotud, cty=maakond, q=otsing, rmin ja rmax käive eurodes. Kuni 1000 rida.

`GET /api/v1/signals?days=30`

Müügivihjed: hanked, käibe ja töötajate kasv, uued kinnistud, uued domeenid jm. days (0 täna, 1 eile, kuni 90) või from ja to (AAAA-KK-PP), types=tüüp,tüüp. open=all avab kontaktid kuu kontaktide jäägi piires, avamata kontaktid on peidetud. Kuni 1000 rida.

`GET /api/v1/changes?since=2026-10-01`

Jälgitavate firmade muutused alates kuupäevast: maksuvõlad, juhatuse muutused, pankrotid, aruanded.

Tingimused

Andmeid kasutatakse oma äritegevuses, edasimüük ja avaldamine ei ole lubatud. Isikukoode Firmo ei väljasta. Küsimused: [email protected]. Paketid ja hinnad