Transaction Endpoints

Get transaction receipt

Changed on Nov 3, 2026

Get the receipt/status for a submitted transaction. Works for all transaction types including listing fulfillments, cross-chain buys, sweeps, offer fulfillments, and token swaps. Poll this endpoint after submitting transactions to check completion status.

post/api/v2/transactions/receipt

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/transactions/receipt/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

relay_request_idstring nullable

Relay request ID for cross-chain tracking

request_idstring nullable

Request ID for workflow tracking

Example request

{
  "swap_quote": {
    "from_assets": [
      {
        "amount": "1000000000000000000",
        "chain": "ethereum",
        "contract": "0x0000000000000000000000000000000000000000",
        "token_id": "1234"
      }
    ],
    "to_assets": [
      {
        "amount": "1000000000000000000",
        "chain": "ethereum",
        "contract": "0x0000000000000000000000000000000000000000",
        "token_id": "1234"
      }
    ]
  },
  "transaction_identifiers": [
    {
      "chain": "ethereum",
      "swap_provider": "RELAY",
      "transaction_hash": "0xabc123..."
    }
  ]
}

Response

Transaction receipt retrieved

cross_chain_refundedboolean nullable

Whether a cross-chain refund was issued

fail_reasonstring nullable

Reason for failure, if applicable

statusstring required

Transaction status: PENDING, SUCCESS, PARTIAL_SUCCESS, or FAILED

Example response

{
  "asset_receipts": [
    {
      "asset": {
        "chain": "ethereum",
        "contract": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
        "token_id": "1234"
      },
      "price": {
        "amount": "5.5",
        "currency": "ETH",
        "usd": "19250.0"
      },
      "quantity": "1"
    }
  ],
  "failed_asset_receipts": [
    {
      "asset": {
        "chain": "ethereum",
        "contract": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
        "token_id": "1234"
      },
      "price": {
        "amount": "5.5",
        "currency": "ETH",
        "usd": "19250.0"
      },
      "quantity": "1"
    }
  ],
  "missing_assets": [
    {
      "chain": "ethereum",
      "contract": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
      "token_id": "1234"
    }
  ],
  "status": "SUCCESS",
  "total_spent": {
    "price_per_token": [
      {
        "amount": "5.5",
        "currency": "ETH",
        "usd": "19250.0"
      }
    ]
  }
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property /// became nullable for the status
- info
  the request property became nullable
- info
  the request property became nullable
- info
  the request property /// became nullable
- info
  the request property / became nullable
- info
  the request property /// became nullable
- info
  the request property became nullable
- info
  the request property // became nullable
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history