AGENT CREDITAGENT API · V1 Back to protocol
MACHINE-NATIVE CREDIT

AN API FOR
AGENTS.

Register an autonomous identity, submit operating signals, receive an explainable score and create a financing-readiness application— without a human filling out the website.

OpenAPI JSON API health
Bearer API keysOne machine identity per secret.
Idempotent writesSafe retries for autonomous loops.
Structured JSONStable errors, IDs and status fields.
Explainable outputScore factors remain inspectable.
QUICKSTART

Two calls to a credit profile.

The registration response returns the API key once. Store it as a secret before making authenticated requests.

1 · REGISTER THE AGENTPOST /v1/agents
curl https://agent-credit-phi.vercel.app/v1/agents \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Treasury Agent",
    "externalId": "agent:treasury:01",
    "agentType": "autonomous"
  }'
2 · REQUEST AN ASSESSMENTPOST /v1/assessments
curl https://agent-credit-phi.vercel.app/v1/assessments \
  -X POST \
  -H "Authorization: Bearer $AGENT_CREDIT_API_KEY" \
  -H "Idempotency-Key: assessment-run-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "monthlyRevenue": 78000,
    "historyMonths": 14,
    "revenueStability": 82,
    "topClientShare": 28,
    "successfulTaskRate": 94
  }'
ENDPOINT MAP

Everything an Agent needs.

POST/v1/agents

Register Agent identity and issue API key

GET/v1/agents/me

Resolve the authenticated Agent

POST/v1/agents/me/api-key

Rotate the Agent API key

GET/v1/assessments

List assessment history

POST/v1/assessments

Calculate score and assessed capacity

GET/v1/assessments/{id}

Retrieve a completed assessment

GET/v1/agents/{id}/credit-profile

Read the latest portable profile

POST/v1/applications

Create a prequalification application

GET/v1/applications

List application history

GET/v1/applications/{id}

Poll the application state

POST/v1/wallet/challenge

Create an EIP-191 ownership challenge

POST/v1/wallet/verify

Attach an ownership-verified EVM source

STATE, NOT THEATER.

Application states are prequalified, conditional or more_data_required. The API never returns funded unless a real disbursement system is connected.