Get Identity Attestations

Get identity attestations for an Ethereum address

GET /api/v2/identity/address/{address}/attestations

cURL

curl -X GET "https://api.credprotocol.com/api/v2/identity/address/vitalik.eth/attestations" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "ens": {
    "primary_name": "vitalik.eth",
    "owned_names": ["vitalik.eth", "vbuterin.eth"],
    "avatar": "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
  },
  "gitcoin_passport": {
    "score": 42.5,
    "stamps": [
      {
        "provider": "Google",
        "verified": true
      },
      {
        "provider": "Twitter",
        "verified": true
      },
      {
        "provider": "GitHub",
        "verified": true
      }
    ]
  },
  "poaps": {
    "count": 156,
    "events": [
      {
        "name": "ETHDenver 2024",
        "date": "2024-02-29"
      },
      {
        "name": "Devcon VI",
        "date": "2022-10-11"
      }
    ]
  },
  "social": {
    "lens": "vitalik.lens",
    "farcaster": "vitalik.eth"
  },
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

Overview

Returns identity attestations and verification data for the specified Ethereum address, including ENS domains, Gitcoin Passport, POAPs, and other identity signals.

Identity data is useful for verifying the legitimacy of an address and can boost credit scores.

Authentication

This endpoint supports two authentication methods:

Method	Header	Cost
API Token	Authorization: Bearer YOUR_API_KEY	1 Cred Unit
x402 Payment	X-PAYMENT: <signed_payment>	$0.01 USDC

x402 payments allow instant, accountless access. Pay per request with USDC on Base — no signup required. Try it live →

Path Parameters

address · string · required

Ethereum address or ENS name (e.g., vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17)

Response

address · string

The resolved Ethereum address (checksummed)

ens · object

ENS (Ethereum Name Service) data

ens.primary_name · string

Primary ENS name set for this address

ens.owned_names · array

List of ENS names owned by this address

gitcoin_passport · object

Gitcoin Passport verification data

gitcoin_passport.score · number

Gitcoin Passport humanity score (0-100)

gitcoin_passport.stamps · array

List of verified stamps/credentials

poaps · object

POAP (Proof of Attendance Protocol) data

poaps.count · integer

Total number of POAPs owned

poaps.events · array

List of POAP events attended

social · object

Social profile links (if available)

cached · boolean

Whether the response was served from cache

Data Sources

Source	Description
ENS	Ethereum Name Service domains
Gitcoin Passport	Sybil resistance and identity verification
POAPs	Proof of Attendance Protocol tokens
Lens Protocol	Decentralized social profile
Farcaster	Web3 social network profile

cURL

curl -X GET "https://api.credprotocol.com/api/v2/identity/address/vitalik.eth/attestations" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "ens": {
    "primary_name": "vitalik.eth",
    "owned_names": ["vitalik.eth", "vbuterin.eth"],
    "avatar": "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
  },
  "gitcoin_passport": {
    "score": 42.5,
    "stamps": [
      {
        "provider": "Google",
        "verified": true
      },
      {
        "provider": "Twitter",
        "verified": true
      },
      {
        "provider": "GitHub",
        "verified": true
      }
    ]
  },
  "poaps": {
    "count": 156,
    "events": [
      {
        "name": "ETHDenver 2024",
        "date": "2024-02-29"
      },
      {
        "name": "Devcon VI",
        "date": "2022-10-11"
      }
    ]
  },
  "social": {
    "lens": "vitalik.lens",
    "farcaster": "vitalik.eth"
  },
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

Use Cases

Sybil Resistance

Use Gitcoin Passport scores to verify that an address represents a unique human, reducing the risk of sybil attacks in airdrops or governance.

User Verification

Display ENS names and social profiles to provide a more human-readable identity for wallet addresses in your application.

Community Engagement

Check POAP holdings to verify attendance at events or membership in communities.

Performance

• Response Time: Typically 1-3 seconds
• Caching: Results cached for 5 minutes per address