Skip to content
VynCo is in public beta — we'd love your feedback.

Sistema di crediti

Comprenda come funzionano i crediti VynCo — costi per operazione, quote per livello, fatturazione del consumo eccessivo e best practice

How It Works

Every API operation that retrieves or generates data costs a fixed number of credits. Credits are deducted from your team's monthly balance when a request succeeds. Management operations (balance, API keys, team info) are always free.

Fixed per-operation cost

Each endpoint has a deterministic credit cost. No surprise charges based on response size.

Debit on success only

Credits are only consumed on HTTP 2xx responses. Failed requests are never charged.

Real-time visibility

Every response includes X-Credits-Used and X-Credits-Remaining headers.

Operation Costs

The table below lists the credit cost for every API operation. Simple lookups cost 1 credit; AI dossiers scale with depth.

OperationEndpointCreditsAvailable on
Company SearchGET /companies1 creditAll
Company DetailGET /companies/{uid}2 creditsAll
Company EventsGET /companies/{uid}/events2 creditsAll
Auditor HistoryGET /companies/{uid}/auditor-history2 creditsAll
Company NewsGET /companies/{uid}/news2 creditsAll
Company RelationshipsGET /companies/{uid}/relationships2 creditsAll
Company FingerprintGET /companies/{uid}/fingerprint2 creditsAll
Nearby CompaniesGET /companies/nearby2 creditsAll
Board MembersGET /persons/board-members/{uid}2 creditsAll
Changes FeedGET /changes1 creditAll
Analytics (basic)GET /analytics/cantons2 creditsAll
Entity ScreeningPOST /screening5 creditsStarter+
AI Risk ScorePOST /ai/risk-score5 creditsStarter+
Company ComparisonPOST /companies/compare5 creditsStarter+
Network AnalysisPOST /network/analyze5 creditsProfessional+
Advanced AnalyticsPOST /analytics/cluster, /analytics/anomalies5 creditsProfessional+
AI Natural Language SearchPOST /ai/search10 creditsProfessional+
Bulk ExportPOST /exports10 creditsProfessional+
Excel ExportPOST /companies/export/excel10 creditsProfessional+
AI Dossier GenerationPOST /ai/dossier50 creditsProfessional+
Free operationsHealth, blog, dashboard, sync, auth, teams, billing, settings, notifications, API keys0 creditsAll

Tier Allowances

Each plan includes a monthly credit allowance. Credits reset at the start of every billing period and do not roll over.

TierPriceIncluded CreditsOverage
FreeCHF 0/mo500Blocked
StarterCHF 49/mo25,000CHF 0.003/credit
ProfessionalCHF 199/mo150,000CHF 0.002/credit
EnterpriseCustomUnlimitedIncluded

Need more credits? Compare plans or contact sales for a custom Enterprise arrangement.

Overage Billing

When a paid tier exhausts its included credits, additional credits are automatically consumed from an overage pool. Overage is billed at the end of the billing period.

text
Overage example (Starter tier):
Monthly included credits:  25,000
Credits used this month:   26,500
Overage credits:            1,500
Overage rate:          CHF 0.003/credit
Overage charge:        CHF 4.50
Billed at period end on top of the CHF 49/mo subscription.

The Free tier does not support overage — requests are blocked once the 500 credit allowance is exhausted. Upgrade to Starter or above to enable overage billing.

Tracking Your Usage

Monitor credit consumption via the API, response headers, or the Usage dashboard.

Credit Balance

Bash
# Check current credit balance
curl "https://vynco.ch/api/v1/credits/balance" \
  -H "Authorization: Bearer vc_live_abc123..."
JSON
{
  "balance": 4250,
  "tier": "standard",
  "periodStart": "2026-03-01T00:00:00Z",
  "periodEnd": "2026-03-31T23:59:59Z"
}

Usage Breakdown

Bash
# Get usage breakdown by operation
curl "https://vynco.ch/api/v1/credits/usage" \
  -H "Authorization: Bearer vc_live_abc123..."
JSON
{
  "period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "totalUsed": 1250,
  "breakdown": [
    { "operation": "CompanySearch",   "count": 840, "creditsUsed": 840 },
    { "operation": "EnrichedProfile", "count": 62,  "creditsUsed": 310 },
    { "operation": "DossierSummary",  "count": 5,   "creditsUsed": 100 }
  ]
}

Per-Response Headers

http
# Credits are also returned in every response header
HTTP/2 200
X-Credits-Used: 5
X-Credits-Remaining: 4250
X-Rate-Limit-Limit: 30
X-Request-Id: req_abc123
X-Data-Source: Zefix

Best Practices

Follow these guidelines to make the most of your credit allowance.

Cache company lookups

Company data changes infrequently. Cache GET /companies/{uid} responses for at least 24 hours to avoid redundant credit spend.

Use search before lookup

A search (1 credit) returns UIDs in bulk. Only fetch full company details (2 credits) for companies you actually need.

Monitor X-Credits-Remaining

Log the X-Credits-Remaining header in every response. Alert your team when the balance drops below a threshold.

Choose the right dossier level

AI dossiers cost 50 credits each. Use entity screening (5 credits) for quick checks and reserve dossiers for final due diligence.

Poll /credits/usage regularly

Set up a daily cron job that calls GET /credits/usage and reports per-operation totals to your team.

Use test keys in CI

vc_test_* keys run in sandbox mode and do not consume credits. Use them in automated tests and staging environments.

Frequently Asked Questions

Common questions about the credit system.