Submission Status

curl -X GET "https://api.credprotocol.com/api/v2/agents/18/reputation/status/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

const agentId = 18;
const submissionId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.credprotocol.com/api/v2/agents/${agentId}/reputation/status/${submissionId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await response.json();
console.log(`Status: ${data.status}`);
if (data.scores) {
  console.log(`Credit Score: ${data.scores.credit_score}`);
}

import requests

agent_id = 18
submission_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.credprotocol.com/api/v2/agents/{agent_id}/reputation/status/{submission_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Status: {data['status']}")
if data.get('scores'):
    print(f"Credit Score: {data['scores']['credit_score']}")

{
  "submission_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": 18,
  "status": "confirmed",
  "scores": {
    "credit_score": 782,
    "sybil_score": 12,
    "identity_count": 3
  },
  "transactions": [
    {
      "tag1": "creditScore",
      "transaction_hash": "0xabc123...",
      "block_number": 12345678,
      "gas_used": 85000
    },
    {
      "tag1": "sybilRisk",
      "transaction_hash": "0xdef456...",
      "block_number": 12345679,
      "gas_used": 82000
    }
  ],
  "feedback_uri": "ipfs://QmXyz...",
  "error": null,
  "created_at": "2026-02-27T15:30:00Z",
  "updated_at": "2026-02-27T15:30:45Z"
}

{
  "detail": "Submission not found"
}

GET

api

agents

{agent_id}

reputation

status

{submission_id}

curl -X GET "https://api.credprotocol.com/api/v2/agents/18/reputation/status/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

const agentId = 18;
const submissionId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.credprotocol.com/api/v2/agents/${agentId}/reputation/status/${submissionId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await response.json();
console.log(`Status: ${data.status}`);
if (data.scores) {
  console.log(`Credit Score: ${data.scores.credit_score}`);
}

import requests

agent_id = 18
submission_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.credprotocol.com/api/v2/agents/{agent_id}/reputation/status/{submission_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Status: {data['status']}")
if data.get('scores'):
    print(f"Credit Score: {data['scores']['credit_score']}")

{
  "submission_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": 18,
  "status": "confirmed",
  "scores": {
    "credit_score": 782,
    "sybil_score": 12,
    "identity_count": 3
  },
  "transactions": [
    {
      "tag1": "creditScore",
      "transaction_hash": "0xabc123...",
      "block_number": 12345678,
      "gas_used": 85000
    },
    {
      "tag1": "sybilRisk",
      "transaction_hash": "0xdef456...",
      "block_number": 12345679,
      "gas_used": 82000
    }
  ],
  "feedback_uri": "ipfs://QmXyz...",
  "error": null,
  "created_at": "2026-02-27T15:30:00Z",
  "updated_at": "2026-02-27T15:30:45Z"
}

{
  "detail": "Submission not found"
}

Overview

Poll this endpoint to track the progress of an on-chain reputation submission. Returns the current status, computed scores (once available), and transaction details after confirmation.

This is a free endpoint (0 Cred Units). Poll every 5–10 seconds until the status is confirmed or failed.

Authentication

Method	Header	Cost
API Token	`Authorization: Bearer YOUR_API_KEY`	0 Cred Units
x402 Payment	`X-PAYMENT: <signed_payment>`	Free

Path Parameters

integer

required

ERC-8004 agent ID. Must be >= 1.

string

required

Submission UUID returned by the submit endpoint

Response

string

UUID tracking this submission

integer

The ERC-8004 agent ID

string

Current status: pending, scoring, uploading, submitting, confirmed, or failed

object

Computed scores (available after the scoring phase)

integer

Andromeda 1.0 credit score (300–1000)

integer

Sybil risk score (0–100)

integer

Number of verified identity attestations

array

On-chain transaction details per tag (available after confirmation)

string

Feedback tag (e.g., creditScore)

string

Transaction hash on Base

integer

Block number of confirmation

integer

Gas used by the transaction

string

IPFS URI of the off-chain feedback JSON

string

Error message if status is failed

string

ISO 8601 timestamp when the submission was created

string

ISO 8601 timestamp when the submission was last updated

curl -X GET "https://api.credprotocol.com/api/v2/agents/18/reputation/status/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

const agentId = 18;
const submissionId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.credprotocol.com/api/v2/agents/${agentId}/reputation/status/${submissionId}`,
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const data = await response.json();
console.log(`Status: ${data.status}`);
if (data.scores) {
  console.log(`Credit Score: ${data.scores.credit_score}`);
}

import requests

agent_id = 18
submission_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.credprotocol.com/api/v2/agents/{agent_id}/reputation/status/{submission_id}',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Status: {data['status']}")
if data.get('scores'):
    print(f"Credit Score: {data['scores']['credit_score']}")

{
  "submission_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": 18,
  "status": "confirmed",
  "scores": {
    "credit_score": 782,
    "sybil_score": 12,
    "identity_count": 3
  },
  "transactions": [
    {
      "tag1": "creditScore",
      "transaction_hash": "0xabc123...",
      "block_number": 12345678,
      "gas_used": 85000
    },
    {
      "tag1": "sybilRisk",
      "transaction_hash": "0xdef456...",
      "block_number": 12345679,
      "gas_used": 82000
    }
  ],
  "feedback_uri": "ipfs://QmXyz...",
  "error": null,
  "created_at": "2026-02-27T15:30:00Z",
  "updated_at": "2026-02-27T15:30:45Z"
}

{
  "detail": "Submission not found"
}

Submit Reputation Feedback Reputation Summary

API Reference

Score

Report

Identity

Agents

Sandbox

Overview

Authentication

Path Parameters

Response

​Overview

​Authentication

​Path Parameters

​Response

Overview

Authentication

Path Parameters

Response