Contact SalesStart Free

AI API

Use AI API to enrich company data, score records, and run AI-assisted buying workflows with structured results.

Last updated: July 14, 2026

Summary

Use AI API when your product or integration needs Sanka to return structured AI outputs or run AI-assisted business workflows, not freeform chat. The current AI API covers company enrichment, company or deal scoring, and beta buying workflows.AI API endpoints use the root /v2 namespace. Buy API endpoints use /v2/buy/.... Object API endpoints use /v2/public/....

What's included

Buy
Turn purchase intent into sourced offers, Purchase Orders, checkout handoff, Bills, and accounting readiness checks.
Enrichment
Fill missing company fields or refresh stale company data from external evidence.
Scoring
Score companies or deals and return dimensions, reasons, warnings, and suggested next actions.
Each API page includes examples and workflow guidance. Enrichment and Scoring also include interactive playgrounds. This overview explains when to use each one and how to wire it into a workflow.

How to use it

  1. Create a Developer API key.
  2. Decide whether you are enriching a company, scoring a company or deal, or starting a buying workflow.
  3. Pass an existing Sanka record ID when you want the result tied to a workspace record.
  4. Use dry_run first for enrichment when you want proposed changes without writing to the record.
  5. Use Idempotency-Key for Buy API write operations.
  6. Store returned reasons, evidence, or generated record IDs so users can understand the result.
Example enrichment preview:
cURL
curl -X POST "https://api.sanka.com/v2/enrich" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "company",
    "record_id": "<company_record_id>",
    "dry_run": true
  }'
Use a key that is allowed to call AI endpoints. If the request writes enriched data back to a Sanka record, use a key with write access.

Choose the right API

GoalUse
Complete missing company detailsEnrichment
Refresh stale company profile dataEnrichment
Prioritize target accountsScoring
Explain why a company or deal is high priorityScoring
Turn purchase intent into a purchasing workflowBuy
Create Purchase Orders and Bills from sourced offersBuy
Find new companies before enrichmentData API
Create or update the actual recordObject API
If the company does not exist in Sanka yet, use Data API to discover candidates first, then create or update the record with Object API.

Next steps

  • Open Buy to create AI-assisted purchase requests and hand them off to Purchase Orders and Bills.
  • Open Enrichment to test company enrichment.
  • Open Scoring to test company or deal scoring.
  • Review Rate Limits before running batch jobs.
  • Use Object API to persist records and related business data.
PreviousSanka Python SDKNextBuy API