Contact SalesStart Free

Data Scoring

Use the Data Scoring API to score companies and deals with deterministic outputs.

Last updated: July 5, 2026

Summary

The Data Scoring group contains the POST /v2/score endpoint and its interactive playground.Use POST /v2/score to score a company or deal and get a deterministic response with structured reasons.Scoring is idempotent for the same normalized input and algorithm version.

Authentication

  • Send your Developer API key as Authorization: Bearer <api_key>
  • Use Full access because this endpoint uses POST

Coverage

  • v2 supports object_type=company and object_type=deal
  • score snapshots are deterministic for the same normalized input and algorithm version
  • responses include dimensions, reasons, and explanation

What scoring returns

Each scoring response includes:
  • score: integer from 0 to 100
  • band: low, medium, good, or very_good
  • dimensions: weighted scoring dimensions
  • reasons: structured supporting reasons
  • explanation: compact natural-language summary
  • algorithm_version, input_hash, and output_hash for deterministic snapshots

Score a company

cURL
curl -X POST "https://api.sanka.com/v2/score" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "company",
    "record_id": "11111111-2222-3333-4444-555555555555"
  }'
Company scoring combines firmographic fit and record quality signals.

Score a deal

cURL
curl -X POST "https://api.sanka.com/v2/score" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "deal",
    "record_id": "66666666-7777-8888-9999-000000000000"
  }'
Deal scoring combines qualification hygiene, engagement recency, pipeline progression, and associated company quality.

Interpret the result

Typical response shape:
JSON
{
  "data": {
    "object_type": "deal",
    "record_id": "<record_uuid>",
    "snapshot_id": "<snapshot_uuid>",
    "algorithm_key": "deal_score_v1",
    "algorithm_version": "v1",
    "input_hash": "<sha256>",
    "output_hash": "<sha256>",
    "score": 78,
    "band": "good",
    "dimensions": [],
    "reasons": [],
    "explanation": "Strong qualification hygiene with room to improve activity freshness."
  },
  "message": "ok",
  "ctx_id": "<ctx_id>"
}
Use the interactive playground in the OpenAPI reference on this page to test both company and deal requests.
PreviousPOST Enrich RecordNextPOST Score Record