Quickstart

Register an AI system, classify it under the EU AI Act and see what you must do, in about five minutes.

1. Create an API key

In V77 Trust, an admin opens Settings → API keys and creates a key. Pick the ai_owner role to create and update records. The key starts with v77_ and is shown once, so store it in your secrets manager.

export V77_API_KEY="v77_..."

2. Check the key

curl https://v77trust.com/api/v1/me -H "Authorization: Bearer $V77_API_KEY"

3. Add an AI system

curl https://v77trust.com/api/v1/systems \
  -H "Authorization: Bearer $V77_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "Retail credit scoring",
    "intendedPurpose": "Assess the creditworthiness of consumers applying for loans",
    "roleInValueChain": "provider",
    "sector": "banking_credit",
    "lifecycleStatus": "production"
  }'

4. Classify it

Fetch the questions from GET /classification/questions, then answer the ones that apply. Credit scoring of natural persons falls under Annex III point 5(b):

curl https://v77trust.com/api/v1/systems/$SYSTEM_ID/classification \
  -H "Authorization: Bearer $V77_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "answers": { "hr_annex_iii_credit": "yes", "lim_interaction": "no" } }'

The response gives the tier, the reasons and the id of the assessment that was opened with the controls that apply:

{
  "object": "classification",
  "riskTier": "high_risk",
  "gpai": false,
  "reasons": ["High-risk Annex III indicator (hr_annex_iii_credit)."],
  "assessmentId": "9b1c…",
  "disclaimer": "Automated screening against EU AI Act categories. Not legal advice…"
}
Add "dryRun": true to preview the tier without saving anything.

5. See what you must do

curl https://v77trust.com/api/v1/systems/$SYSTEM_ID/obligations -H "Authorization: Bearer $V77_API_KEY"

Next