Get Transaction By Hash

Retrieve a single transaction by its blockchain hash/identifier, accessible to the authenticated API user(business).

Endpoint Details

Method: GET
Path: /api/transaction/{hash}
Authentication: Required (API Key)

Request

GET /api/transaction/{hash}
Authorization: Bearer <your_api_key>
Accept: application/json

Path Parameter

Example Request

GET /api/transaction/0x9a7...e21
Authorization: Bearer <your_api_key>
Accept: application/json

Response

Success Response (200)

{
  "message": "transaction successfully fetched",
    "status": "success",
    "data": {
        "id": "uuid",
        "business_id": "uuid",
        "hash_url": "string",
        "reference": "string",
        "transaction_type": "string",
        "status": "string",
        "mode": "string",
        "channel": "string",
        "source": "string",
        "destination": "string",
        "narration": "string",

        "from_address": "string",
        "from_amount": "string",
        "from_currency": "string",
        "from_network": "string",
        "from_currency_has_minor": false,

        "to_address": "string",
        "to_amount": "string",
        "to_currency": "string",
        "to_network": "string",
        "to_currency_has_minor": false,

        "fee": 0,
        "fee_currency": "string",
        "fee_currency_has_minor": false,

        "business_id": "uuid",
        "destination": null,

        "created_at": "2023-10-27T10:30:00Z",
        "updated_at": "2023-10-27T10:30:00Z"
  }
}

{
    "message": "transaction successfully fetched",
    "status": "success",
    "data": {
                "id": "7e521ac2-9d2c-4078-8a7a-32c67a073042",
                "business_id": "33c248f4-8644-40f5-9c4a-e2e17426a709",
                "source": "crypto-wallet",
                "destination": "crypto-wallet",
                "reference": "VACWF2510030822377VY6Q011",
                "mode": "credit",
                "transaction_type": "Wallet Funding",
                "status": "success",
                "from_amount": "10",
                "from_currency": "USDC",
                "from_currency_has_minor": false,
                "from_network": "ERC20",
                "to_amount": "10",
                "to_currency": "USDC",
                "to_currency_has_minor": false,
                "to_network": "ERC20",
                "narration": "Wallet Funding From External to Olawale",
                "created_at": "2025-10-03T08:22:37.167937Z",
                "updated_at": "2025-10-03T08:22:37.167937Z",
                "completed_at": "2025-10-03T08:22:37.167936Z",
                "from_address": "0x3C3380cdFb94dFEEaA41cAD9F58254AE380d752D",
                "to_address": "0x6BECC92E4c75F833D4036545dD4Aa84aaF8583ec",
                "hash_url": "https://sepolia.etherscan.io/tx/0x1309904d45312..."
    }
}

Error Responses

Status Code	Description
400	Invalid input or malformed query parameters
401	Unauthorized - Invalid or missing API key
500	Internal server error

Data Models

Transaction Object

Field	Type	Description
`id`	uuid	Unique transaction identifier
`business_id`	string	Owning business identifier
`source`	string	Transaction source
`destination`	string	Transaction destination
`reference`	object	System reference for reconciliation
`mode`	string	Processing mode - credit or debit
transaction_type	string	Transaction type
status	string	Current status of the transaction
from_amount	float64	Source amount
from_currency	string	Asset type (e.g., USDT, USDC)
from_currency_has_minor	bool	Whether source currency has a minor unit
from_network	string	Blockchain network (e.g., ERC20, TRC20)
to_amount	float64	Destination amount
to_currency	string	Asset type (e.g., USDT, USDC)
to_currency_has_minor	bool	Whether destination currency has a minor unit
to_network	string	Blockchain network (e.g., ERC20, TRC20)
fee	float64	Total fee
fee_currency	string	Asset type (e.g., USDT, USDC)
fee_currency_has_minor	bool	Whether fee currency has a minor unit
narration	string	Narration of the transaction; may be omitted
failure_reason	string	Failure reason if applicable; may be omitted
from_address	string	Sender wallet address; may be omitted
to_address	string	Recipient wallet address; may be omitted
hash_url	string	Hash URL on the blockchain; may be omitted
history	object	Change history entries for this transaction
`created_at`	timestamp	ISO-8601 formatted creation timestamp
`updated_at`	timestamp	ISO-8601 formatted last update timestamp; may be omitted
`completed_at`	timestamp	ISO-8601 formatted last completed timestamp; may be omitted

Change History Object

Field	Type	Description
`id`	uuid	ID of the change history object
`business_id`	uuid	ID of the business
`object_ref`	string	object name
`object_id`	uuid	id of the object
`comment`	string	[Optional] comment(s)
`status`	string	status of the history data
`submitted_by`	string	user who committed the change
`created_at`	timestamp	time at which the change was committed

Usage Examples

Basic Request

curl -X GET "https://ba-be-stg.usevaulta.com/v1/api/transaction/0x1309904d45312..." \
  -H "Authorization: Bearer your_api_key" \
  -H "Accept: application/json"