OpenSea · Schema

TransactionReceiptResponse

Transaction receipt with status and asset details

NFTMarketplaceWeb3BlockchainTradingDigital Assets

Properties

Name Type Description
status string Transaction status: PENDING, SUCCESS, PARTIAL_SUCCESS, or FAILED
fail_reason string Reason for failure, if applicable
asset_receipts array Successfully received assets
failed_asset_receipts array Assets that failed to be received
total_spent object Total amount spent across all assets
missing_assets array Assets that are missing from the receipt
cross_chain_refunded boolean Whether a cross-chain refund was issued
View JSON Schema on GitHub

JSON Schema

TransactionReceiptResponse.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opensea.io/schemas/TransactionReceiptResponse",
  "title": "TransactionReceiptResponse",
  "type": "object",
  "description": "Transaction receipt with status and asset details",
  "properties": {
    "status": {
      "type": "string",
      "description": "Transaction status: PENDING, SUCCESS, PARTIAL_SUCCESS, or FAILED",
      "example": "SUCCESS"
    },
    "fail_reason": {
      "type": "string",
      "description": "Reason for failure, if applicable"
    },
    "asset_receipts": {
      "type": "array",
      "description": "Successfully received assets",
      "items": {
        "$ref": "#/components/schemas/AssetReceiptResponse"
      }
    },
    "failed_asset_receipts": {
      "type": "array",
      "description": "Assets that failed to be received",
      "items": {
        "$ref": "#/components/schemas/AssetReceiptResponse"
      }
    },
    "total_spent": {
      "$ref": "#/components/schemas/TotalSpentResponse",
      "description": "Total amount spent across all assets"
    },
    "missing_assets": {
      "type": "array",
      "description": "Assets that are missing from the receipt",
      "items": {
        "$ref": "#/components/schemas/AssetIdentifierResponse"
      }
    },
    "cross_chain_refunded": {
      "type": "boolean",
      "description": "Whether a cross-chain refund was issued"
    }
  },
  "required": [
    "asset_receipts",
    "failed_asset_receipts",
    "missing_assets",
    "status",
    "total_spent"
  ]
}