IsDelegate API

Public endpoint to verify IsDelegate attestation chains on a wallet

The IsDelegate API is a public endpoint (no authentication) that checks whether an Ethereum wallet has a valid IsDelegate attestation chain. Use it to verify that a wallet is delegated to act on behalf of a verified identity before trusting it (e.g. in agents, integrations, or access control).

Endpoint: GET /api/v1/is-delegate/{walletAddress} Category: Zipwire Attest

---

Request

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

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

---

Response

The endpoint always returns HTTP 200 OK. Success or failure is indicated in the response body. Check the success field to determine the result.

Success

The wallet has a valid IsDelegate attestation chain.

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

Field	Description
attestationUid	On-chain attestation identifier.
attestationExplorerUrl	Link to view the attestation in the chain explorer.
valid	Whether this attestation passed validation.
pointsToHuman	Whether the delegation chain resolves to a verified human identity.

Invalid wallet address

The address format is not a valid Ethereum address.

{
  "success": false,
  "message": "Invalid Ethereum wallet address: not-an-address",
  "code": "InvalidWalletAddress",
  "walletAddress": null,
  "attestations": null
}

No attestations found

The wallet has no IsDelegate attestations.

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

---

Error codes

Code	Meaning
InvalidWalletAddress	Wallet address format is invalid.
NoAttestationsFound	No IsDelegate attestations exist for this wallet.
ValidationFailed	Attestation failed validation (e.g. revoked or expired).
ProofPackValidationError	ProofPack validation failed.
InternalError	Server error; try again later.

---

How validation works

• The wallet address is checked against standard Ethereum address rules.

• Each attestation is validated (revocation, expiration, and chain integrity).

• The delegation chain is followed to a trusted root (e.g. Zipwire identity attestations).

• Authority continuity is checked so the chain is consistent.

For more on IsDelegate and how to use it in your app, see IsDelegate: Agent Delegation & Authorization and IsDelegate REST API.