IsDelegate REST API

Simple REST API for checking if a wallet is authorized by a human

A simple public API for checking if a wallet has valid IsDelegate attestations.

When to Use

Use this API for:

• Quick authorization checks with minimal code

• Simple bot detection

• Verifying agent status without cryptographic validation

Important: This API requires trusting Zipwire's validation. For maximum security and cryptographic verification, use the ProofPack library instead.

Endpoint

GET https://zipwire.io/api/v1/is-delegate/{walletAddress}

Request

Parameter	Type	Description
walletAddress	string	Ethereum wallet address (0x-prefixed)

Response (Success)

{
  "success": true,
  "message": "IsDelegate attestation verified successfully",
  "walletAddress": "0x775d3B494d98f123BecA7b186D7F472026EdCeA2",
  "attestations": [
    {
      "attestationUid": "0x7e08febe71e51acbdcb1d2c6175fb36958594074bed0f1e85b12adc6274eb8b2",
      "attestationExplorerUrl": "https://base.easscan.org/attestation/0x7e08febe71e51acbdcb1d2c6175fb36958594074bed0f1e85b12adc6274eb8b2",
      "valid": true,
      "pointsToHuman": true
    }
  ]
}

Response (No Attestations)

{
  "success": false,
  "message": "No delegation attestations found for wallet",
  "code": "NoAttestationsFound",
  "walletAddress": null,
  "attestations": null
}

Example Usage

JavaScript:

const response = await fetch('https://zipwire.io/api/v1/is-delegate/0x775d3B494d98f123BecA7b186D7F472026EdCeA2');
const result = await response.json();

if (result.success) {
  console.log('Agent is authorized by a human');
} else {
  console.log('Agent is not authorized');
}

cURL:

curl https://zipwire.io/api/v1/is-delegate/0x775d3B494d98f123BecA7b186D7F472026EdCeA2

Notes

• No authentication required (public endpoint)

• Always returns HTTP 200 OK

• Validation includes revocation and expiration checks

• Walks the full delegation chain back to Zipwire's trusted root

For Maximum Security

For cryptographic verification that doesn't require trusting Zipwire's API, use the ProofPack library instead. ProofPack allows you to verify attestations independently on-chain.

---

Related:

• ProofPack Developer Guide

• IsDelegate Attestations