GETpartial

Read the offered fast-track upgrade

Native account-session operation using the internal case ID. Acceptance and decline require a current signed-in party or a representative authorized to consent to arbitration. OAuth and partner bearer credentials cannot authorize this operation. Both parties accept the exact offered Record, target terms and fee delta. No MCP operation is exposed. Decline, expiry and integrity termination follow the pinned refund policy. Repeated acceptance cannot create a second fee. A waived target procedure also requires separate appealWaiverAccepted true acknowledgment; an unwaived target permits only absent or false.

/api/cases/{id}/fast-track-upgradegetNativeFastTrackUpgrade

Authentication and authority

Use one listed account-session, scoped OAuth, or partner credential alternative. Account tokens retain the approving account’s authority. Cookie-authenticated writes require same-origin authorization. Alternatives are OR; schemes in one alternative are AND.

CanonicalSession

Parameters

NameLocationRequirementSchema
id

Internal case ID, not a partner public case ID.

pathRequired{"type":"string"}

Responses

200

Current party-visible offer

application/json

{
  "type": "object",
  "required": [
    "ok",
    "data"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "data": {
      "$ref": "#/components/schemas/FastTrackUpgradeOffer",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "offerId",
        "state",
        "recordHash",
        "sourceTermsHash",
        "targetTerms",
        "deltaUsd",
        "feeMethod",
        "expiresAt",
        "acceptedBy",
        "eligible"
      ],
      "properties": {
        "offerId": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "offered",
            "accepted",
            "payment_pending",
            "resumed",
            "declined",
            "expired"
          ]
        },
        "recordHash": {
          "type": "string"
        },
        "sourceTermsHash": {
          "type": "string"
        },
        "targetTerms": {
          "$ref": "#/components/schemas/CaseProcedureTerms",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "schemaVersion",
            "track",
            "appealWaived",
            "waiverDisclosureVersion",
            "waiverDisclosureHash",
            "rulesVersion",
            "rulesHash",
            "behaviorVersion",
            "disclosureVersion",
            "disclosureHash",
            "feePolicyVersion",
            "termsHash"
          ],
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "case-procedure-v1"
            },
            "track": {
              "type": "string",
              "enum": [
                "ai_fast",
                "ai_standard",
                "ai_assisted_human"
              ]
            },
            "appealWaived": {
              "type": "boolean"
            },
            "waiverDisclosureVersion": {
              "type": "string",
              "minLength": 1
            },
            "waiverDisclosureHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "rulesVersion": {
              "type": "string",
              "minLength": 1
            },
            "rulesHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "behaviorVersion": {
              "type": "string",
              "minLength": 1
            },
            "disclosureVersion": {
              "type": "string",
              "minLength": 1
            },
            "disclosureHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "feePolicyVersion": {
              "type": "string",
              "minLength": 1
            },
            "termsHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "deltaUsd": {
          "type": "number",
          "minimum": 0
        },
        "feeMethod": {
          "type": "string",
          "const": "fiat_card"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "paymentDeadlineAt": {
          "type": "string",
          "format": "date-time"
        },
        "acceptedBy": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          }
        },
        "eligible": {
          "type": "boolean"
        },
        "feeRecordId": {
          "type": "string"
        },
        "refundStatus": {
          "type": "string",
          "enum": [
            "pending",
            "complete",
            "reconciliation_required"
          ]
        }
      }
    }
  }
}
default

Operation refused or unavailable; no acceptance is recorded.

application/json

{
  "type": "object",
  "required": [
    "ok",
    "error"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "const": false
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    }
  }
}

Example response

Successful response

{
  "ok": true,
  "data": {
    "offerId": "offerId_test",
    "state": "offered",
    "recordHash": "recordHash_test",
    "sourceTermsHash": "sourceTermsHash_test",
    "targetTerms": {
      "schemaVersion": "case-procedure-v1",
      "track": "ai_fast",
      "appealWaived": false,
      "waiverDisclosureVersion": "waiverDisclosureVersion_test",
      "waiverDisclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "rulesVersion": "rulesVersion_test",
      "rulesHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "behaviorVersion": "behaviorVersion_test",
      "disclosureVersion": "disclosureVersion_test",
      "disclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "feePolicyVersion": "2026-08-test",
      "termsHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "deltaUsd": 0,
    "feeMethod": "fiat_card",
    "expiresAt": "2026-08-09T12:00:00.000Z",
    "acceptedBy": [
      "claimant"
    ],
    "eligible": false
  }
}

Errors

Read the response status and stable error code. See errors and rate limits for recovery. Refresh the resource before resolving a state or digest conflict.

Idempotency and retries

  • For throttling, honor Retry-After when present. Back off on retryable server failures.