Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
identity
/
address
/
{address}
/
attestations
curl -X GET "https://api.credprotocol.com/api/v2/identity/address/vitalik.eth/attestations" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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:
MethodHeaderCost
API TokenAuthorization: Bearer YOUR_API_KEY1 Cred Unit
x402 PaymentX-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

SourceDescription
ENSEthereum Name Service domains
Gitcoin PassportSybil resistance and identity verification
POAPsProof of Attendance Protocol tokens
Lens ProtocolDecentralized social profile
FarcasterWeb3 social network profile
curl -X GET "https://api.credprotocol.com/api/v2/identity/address/vitalik.eth/attestations" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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

Use Gitcoin Passport scores to verify that an address represents a unique human, reducing the risk of sybil attacks in airdrops or governance.
Display ENS names and social profiles to provide a more human-readable identity for wallet addresses in your application.
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