Docs

Vendor Evaluator

Score vendors against weighted criteria with an A-F grade.

Overview

Scores vendors against weighted criteria. The weighted sum is normalized to 0-100 with an A-F grade.

Features

  • Up to 10 vendors.
  • Weighted categories.
  • 0-100 score with A-F grade.
  • Per-category averages.

Use cases

  • Comparing migration vendors.
  • Building a procurement shortlist.

API reference

POST /api/v1/tools/vendor-evaluate

Score vendors against weighted criteria. Each category holds criteria scored 0-10 per vendor; the weighted sum is normalized to a 0-100 score with an A-F grade.

Returns: Per-vendor final score and grade, plus per-category averages for breakdown charts.

Parameters

NameTypeRequiredDefaultDescription
vendors object[] Yes — Array of { id, name, color? } objects (max 10).
categories object[] Yes — Array of { id, name, weight, criteria: [{ id, name, scores: { vendorId: number } }] }.

Example

curl -X POST https://data-migration-tools.com/api/v1/tools/vendor-evaluate \
  -H "Content-Type: application/json" \
  -d '{"vendors":[{"id":"v1","name":"Global IT"},{"id":"v2","name":"SaaS Co"}],"categories":[{"id":"security","name":"Security","weight":1.3,"criteria":[{"id":"enc","name":"Encryption","scores":{"v1":8,"v2":9}},{"id":"soc","name":"SOC 2","scores":{"v1":7,"v2":9}}]}]}'

See the full API reference for all examples and error codes.