GET /api/v1/smart-accounts/sessions/{id}/quota

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-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-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / optional	Signed 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.
`id`	path / required	string

Response 200

Field Type Details

sessionId string (uuid)
required

state

string
required

Values: ["prepared","installing","active","revoking","revoked","expired","stale"]

allocationManifestHash string
required

approvedGroups

array
required

Fields

Field Type Details

id string
required

assetIdentity string
required

decimals integer
required

total value
required Positive uint256 as an exact decimal string.

allocations

array
required

Fields

Field	Type	Details
`id`	string required
`chainId`	integer required
`asset`	string required
`limit`	value required	Positive uint256 as an exact decimal string.
`assetReviewId`	string required

localAllocations

array
required

Fields

Field	Type	Details
`id`	string required
`chainId`	integer required
`asset`	string required
`limit`	value required	Positive uint256 as an exact decimal string.
`assetReviewId`	string required

counters one of
required

observation one of
required

reservationsReleased boolean
required

executionAuthority

boolean
required

Values: [false]

balanceSource

string
required

Values: ["onchain-only"]

atomicAcrossChains

boolean
required

Values: [false]

JSON schema

{
  "type": "object",
  "properties": {
    "sessionId": {
      "$ref": "#/components/schemas/ResourceId"
    },
    "state": {
      "$ref": "#/components/schemas/SessionState"
    },
    "allocationManifestHash": {
      "$ref": "#/components/schemas/Hash"
    },
    "approvedGroups": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ReviewedSessionAllocationGroup"
      }
    },
    "localAllocations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ReviewedSessionAllocation"
      }
    },
    "counters": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/SessionCounter"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "observation": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/SessionCanonicalObservation"
        },
        {
          "type": "null"
        }
      ]
    },
    "reservationsReleased": {
      "type": "boolean"
    },
    "executionAuthority": {
      "type": "boolean",
      "const": false
    },
    "balanceSource": {
      "type": "string",
      "const": "onchain-only"
    },
    "atomicAcrossChains": {
      "type": "boolean",
      "const": false
    }
  },
  "required": [
    "sessionId",
    "state",
    "allocationManifestHash",
    "approvedGroups",
    "localAllocations",
    "counters",
    "observation",
    "reservationsReleased",
    "executionAuthority",
    "balanceSource",
    "atomicAcrossChains"
  ],
  "additionalProperties": false,
  "description": "Approved allocations and observed policy counters. This is not a spendable database balance or a cross-chain atomic budget."
}