Skip to content

GET /transactions/hash/

Retrieve a transaction by its blockchain transaction hash.

GET/v1/transactions/hash/

Authentication

Required: No
Payment: No

Path Parameters

ParameterTypeRequiredDescription
hashstringYesBlockchain transaction hash (0x-prefixed, 66 chars)

Response

Status: 200 OK

{
  "id": "tx_456e7890-e89b-12d3-a456-426614174111",
  "piid": "pi_abc123",
  "payer": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "pay_to": "0x8Ba1f109551bD432803012645Hac136c8cb2bc43",
  "amount": "1200000",
  "asset": "USDC",
  "entry_id": "123e4567-e89b-12d3-a456-426614174000",
  "transaction_hash": "0xabc123def456789abc123def456789abc123def456789abc123def456789abcd",
  "created_at": 1704067200
}

Example Request

curl "https://api.grapevine.fyi/v1/transactions/hash/0xabc123def456789abc123def456789abc123def456789abc123def456789abcd"

Error Responses

404 Not Found

{
  "error": "Transaction not found",
  "code": "NOT_FOUND"
}

The hash may not correspond to a Grapevine payment transaction.

400 Bad Request

{
  "error": "Invalid transaction hash format",
  "code": "INVALID_PARAMETER",
  "details": "Hash must be 0x-prefixed and 66 characters"
}

Use Cases

  • Verify on-chain payments
  • Link blockchain transactions to Grapevine records
  • Payment confirmation flows
  • Audit and reconciliation

Notes

  • Hash must be a valid Ethereum transaction hash
  • Only returns transactions recorded in the Grapevine system
  • Use this to verify that a blockchain transaction was for a Grapevine purchase

Related