Sviluppatori

Documentazione API CredoRisk.

Il cliente richiede un report tramite la tua API. Il tuo backend chiama quindi l API CredoRisk, che genera il report standardizzato e lo restituisce in JSON/PDF.

Avvio rapido

Integrazione

Collega CredoRisk al tuo backend in pochi giorni

L’API è pensata per un uso server-to-server: autenticazione tramite chiave, endpoint stabili, risposte JSON normalizzate. I team di business mantengono lo stesso formato CredoRisk dell’interfaccia web — senza esporre i provider sorgente al cliente finale.

Chiavi API create e revocabili nello spazio cliente
Flusso Francia consigliato: search → france/{siren} → uuid → PDF
Internazionale: paese + identificativo ufficiale
Errori documentati (401, 402, 422…) e timeout consigliati

Crea un account sviluppatore

Avvio rapido — Francia (consigliato)

Flusso Standard Report API: stessa logica dell interfaccia web CredoRisk. Salva l uuid restituito.

# 1) Cerca in Francia per nome (0 crediti)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/search?q=airbus"
# -> leggi results.resultats[].siren

# 2) Genera report Francia (1 credito)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/france/383474814"
# -> salva report.uuid

# 3) Rilettura completa (0 crediti)
curl -sS -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/standard/report/550e8400-e29b-41d4-a716-446655440000"

# 4) PDF (0 crediti)
curl -sS -H "Authorization: Bearer <api_key>" \
  -o report.pdf \
  "https://credorisk.com/api/v1/standard/report/550e8400-e29b-41d4-a716-446655440000/pdf"
      

Per un SIRET a 14 cifre, usa le prime 9 cifre come SIREN. Timeout consigliato: 60-90 s.

Standard Report API API classica (legacy) Prezzi API

Autenticazione

Ogni richiesta e firmata con una chiave API CredoRisk (header Authorization: Bearer o X-API-Key). Il cliente non vede mai il provider sorgente.

Authorization: Bearer <CREDORISK_API_KEY>
or
X-API-Key: <CREDORISK_API_KEY>
          

Prezzi API

L API e gratuita. La fatturazione si basa sui report generati, con sconti volume.

Vedi prezzi report

Formato report CredoRisk

Risposta standardizzata: company, decision, sections.directors, sections.financials, sections.signals. Contratto stabile indipendente dal provider sorgente.

Tracciabilita completa

Tutte le chiamate API sono tracciate. I report standard sono salvati per uuid; l API classica usa report_id.

Flusso consigliato

Francia — Standard Report API

Ricerca per nome, generazione per SIREN, salva UUID, rileggi e scarica PDF.

1) Ricerca

GET /standard/search?q=... - leggi results.resultats[] e SIREN.

2) Generazione

GET /standard/france/{siren} - recupera report.uuid.

3) Rilettura

GET /standard/report/{uuid} - campi credorisk + raw.

4) PDF

GET /standard/report/{uuid}/pdf - download senza credito aggiuntivo.

Report standard

Endpoint /standard/*

GET /api/v1/standard/search?q=...

Cerca in Francia per nome azienda. Risposta: results.resultats (lista aziende).

GET /api/v1/standard/france/{siren}

Genera o restituisce un report completo Francia. Risposta: report.uuid, cached.

GET /api/v1/standard/report/{uuid}

Rilettura con credorisk, raw, source_type.

GET /api/v1/standard/{country}/{identifier}

Report internazionale (fuori dalla Francia).

Storico

API classica (legacy)

Per la Francia, preferisci la Standard Report API sopra.

POST /api/v1/companies/search

Ricerca aziende per paese + criteri.

curl -X POST -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{"countries":"FR","name":"LA REDOUTE","city":"ROUBAIX"}' \
  "https://credorisk.com/api/v1/companies/search"

GET /api/v1/companies/{providerCompanyId}/report

Genera (o restituisce da cache) un report CredoRisk.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/companies/FR30612897/report?country=FR&language=en"

GET /api/v1/reports/{reportId}

Recupera un report salvato tramite identificativo.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/reports/1284"

GET /api/v1/account/credits

Restituisce saldo residuo e utilizzo API mensile.

curl -H "Authorization: Bearer <api_key>" \
  "https://credorisk.com/api/v1/account/credits"

Risposta di esempio report (formato CredoRisk)

{
  "report_id": 1284,
  "credits_cost": 1,
  "source": "live",
  "report": {
    "company": {
      "name": "EXEMPLE SA",
      "country": "FR",
      "status": "Active",
      "reg_no": "123456789",
      "vat_no": "FR00123456789",
      "address": {
        "street": "10 RUE EXEMPLE",
        "city": "PARIS",
        "postcode": "75001",
        "region": "ILE-DE-FRANCE"
      }
    },
    "decision": {
      "score": 72,
      "risk_band": "B",
      "credit_limit": {
        "value": 50000,
        "currency": "EUR"
      },
      "days_beyond_terms": 8
    },
    "sections": {
      "directors": [],
      "financials": [],
      "signals": []
    }
  }
}
      

Principali codici errore

401 — Chiave API mancante o non valida
402 — Crediti insufficienti per generare un report live
403 — Account non verificato
404 — Report non trovato
422 — Parametri non validi
429 — Quota API mensile raggiunta
500 — Errore interno
503 — Servizio ricerca/dati non configurato

Pronto a testare l API?

Crea un account, genera una chiave API CredoRisk e integra rapidamente la generazione report nel flusso cliente.

Crea account Vedi prezzi