Use Cases

Here are common ways developers use the Icebreaker public API. All examples use the base URL https://app.icebreaker.xyz/api/v1/.

Use Case 1: Enrich a user profile with verified social accounts

Look up any Icebreaker user by LinkedIn, GitHub, ETH wallet, or ENS name to retrieve their verified social accounts, credentials, and professional context.

Useful for: enriching user profiles in your app, displaying trust signals, or verifying on-chain identity.

Request

curl --request GET \
     --url https://app.icebreaker.xyz/api/v1/socials/linkedin/danstone \
     --header 'accept: application/json'

Response

{
  "profiles": [
    {
      "profileID": "abc123",
      "displayName": "Dan Stone",
      "bio": "Founder at Icebreaker",
      "location": "New York, NY",
      "channels": [
        {
          "type": "linkedin",
          "isVerified": true,
          "value": "danstone",
          "url": "https://www.linkedin.com/in/danstone"
        }
      ],
      "credentials": [...]
    }
  ]
}

Use Case 2: Query credentials for a wallet address

Retrieve the verifiable credentials attached to an ETH wallet. Useful for gating product features, verifying professional history, or displaying proof of work.

Request

curl --request GET \
     --url https://app.icebreaker.xyz/api/v1/eth/0xABC123... \
     --header 'accept: application/json'

Use Case 3: Integrate Icebreaker data into your product

Use the /socials endpoint to let users import their verified social accounts into your application. This gives your users richer profiles without asking them to re-enter information, and lets you display verified, on-chain-backed social credentials.

For example, show a "Verified on Icebreaker" badge on a user's profile, or surface their connected accounts in a user directory.

Use Case 4: Build on Farcaster and ENS identity

The API supports lookups by Farcaster ID, Farcaster name, and ENS. If you're building a Farcaster or web3 application, you can use these endpoints to enrich your users' profiles with cross-platform social context — pulling in GitHub activity, professional history, and verified credentials alongside on-chain identity.

Request

curl --request GET \
     --url https://app.icebreaker.xyz/api/v1/fid/12345 \
     --header 'accept: application/json'

For the full endpoint reference, including parameters and response schemas, see the API Reference.