Endpoint reference

GET /api/v1/smart-accounts/bindings

Parameters

NameLocationDetails
X-Juicebox-Accountheader / requiredEnrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
X-Juicebox-Signerheader / requiredOwner wallet or authorized bot address that signed this request.
X-Juicebox-Issued-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
X-Juicebox-Expires-Atheader / requiredUnix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
X-Juicebox-Nonceheader / requiredFresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
X-Juicebox-Signatureheader / requiredEIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
X-Juicebox-Grantheader / optionalAuthorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
Idempotency-Keyheader / optionalSigned retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.

Response 200

FieldTypeDetails
itemsarray
required
Fields
FieldTypeDetails
idstring
required
walletobject
required
Fields
FieldTypeDetails
chainIdinteger
required
addressstring
required
manifestIdstring
required
stateHashstring
required
evidenceobject
required
Fields
FieldTypeDetails
chainIdinteger
required

Values: [1,10,8453,42161,84532,421614,11155111,11155420]

blockNumberstring
required
uint256 as a lossless decimal string
blockHashstring
required
timestampstring
required
uint256 as a lossless decimal string
sourcestring
required

Values: ["onchain"]

moduleConfigurationVerifiedboolean
required
executionVerifiedboolean
required

Values: [false]

observationstring
required

Values: ["stored-binding-snapshot"]

JSON schema
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/Hash"
          },
          "wallet": {
            "type": "object",
            "properties": {
              "chainId": {
                "type": "integer",
                "minimum": 1,
                "maximum": 9007199254740991
              },
              "address": {
                "$ref": "#/components/schemas/Address"
              }
            },
            "required": [
              "chainId",
              "address"
            ],
            "additionalProperties": false
          },
          "manifestId": {
            "type": "string"
          },
          "stateHash": {
            "$ref": "#/components/schemas/Hash"
          },
          "evidence": {
            "$ref": "#/components/schemas/BlockEvidence"
          },
          "moduleConfigurationVerified": {
            "type": "boolean"
          },
          "executionVerified": {
            "type": "boolean",
            "const": false
          },
          "observation": {
            "type": "string",
            "const": "stored-binding-snapshot"
          }
        },
        "required": [
          "id",
          "wallet",
          "manifestId",
          "stateHash",
          "evidence",
          "moduleConfigurationVerified",
          "executionVerified",
          "observation"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}