Skip to main content

GET /api/demo

Demo endpoint with sample ENS resolution (always free)

Demonstrates API capabilities by resolving vitalik.eth. Always free - use this to test integration.

Returns a real ENS profile to show what data is available.

Endpoint​

GET https://api.web3identity.com/api/demo

Example Request​

curl -s "https://api.web3identity.com/api/demo" | jq

Responses​

200 Demo ENS profile​

{
  "demo": true,
  "name": "vitalik.eth",
  "resolved": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "avatar": "https://metadata.ens.domains/mainnet/avatar/vitalik.eth"
  },
  "note": "This is a free demo. Full profiles available at /api/ens/{name}"
}

400 Bad request - invalid parameters​

{
  "example": "response"
}

404 Resource not found​

{
  "example": "response"
}

429 Rate Limited​

{
  "example": "response"
}

500 Internal Server Error - Something went wrong on our end​

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

Auto-generated from OpenAPI spec