GET /transactions/
Retrieve a specific transaction by its unique identifier.
GET
/v1/transactions/Authentication
Required: No
Payment: No
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string (UUID) | Yes | Transaction identifier |
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
}Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique transaction identifier |
piid | string | null | Payment Intent ID (if applicable) |
payer | string | Wallet address that made the payment |
pay_to | string | Wallet address that received the payment |
amount | string | Payment amount in wei |
asset | string | Payment asset type (e.g., "USDC") |
entry_id | string | null | Associated feed entry ID |
transaction_hash | string | Blockchain transaction hash |
created_at | number | Transaction timestamp (Unix) |
Example Request
curl "https://api.grapevine.fyi/v1/transactions/tx_456e7890-e89b-12d3-a456-426614174111"Error Responses
404 Not Found
{
"error": "Transaction not found",
"code": "NOT_FOUND"
}400 Bad Request
{
"error": "Invalid transaction ID format",
"code": "INVALID_PARAMETER"
}Use Cases
- View transaction details
- Verify payment completion
- Link transactions to content
Related
- List Transactions - Search transactions
- Get by Hash - Look up by blockchain hash