Retrieve a transaction

GEThttps://api.omise.co/transactions/:id

Returns the transaction matching the provided ID. Use this endpoint to retrieve detailed information about a specific transaction for reconciliation or audit purposes.

---

🔑API Credentials

▼

---

Request Parameters

Required - 1 fieldRequired Parameters

▼

`id`STRING(required)

Transaction identifier. Format: trxn_test_[0-9a-z]+ for test mode or trxn_[0-9a-z]+ for live mode.

Example:"trxn_test_5fzo4nqrnop03djdde1"

---

Responses

200

Successful request

Returns the transaction object matching the provided ID.

Transaction object contains:

• id - Transaction identifier (e.g., trxn_test_5fzo4nqrnop03djdde1)
• object - String value "transaction"
• amount - Transaction amount in smallest currency unit
• currency - Three-letter ISO 4217 currency code
• direction - Direction of funds (credit or debit)
• key - Related object that triggered the transaction
• origin - Original source of the transaction
• transferable_at - ISO 8601 datetime when funds become transferable
• created_at - Transaction creation timestamp (ISO 8601)
• livemode - Boolean indicating live or test mode
• location - API path to retrieve this transaction

401

Unauthorized

Authentication failed. Invalid or missing API key.

Common causes:

• Missing Authorization header
• Invalid secret key
• Using public key instead of secret key
• Incorrect HTTP Basic Auth format

404

Not found

Transaction not found.

Common causes:

• Invalid transaction ID
• Transaction ID from different account
• Mixing test and live mode IDs

---

Code samples

cURL

curl https://api.omise.co/transactions/trxn_test_5fzo4nqrnop03djdde1 \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

transaction = Omise::Transaction.retrieve('trxn_test_5fzo4nqrnop03djdde1')

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

transaction = omise.Transaction.retrieve('trxn_test_5fzo4nqrnop03djdde1')

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const transaction = await omise.transactions.retrieve('trxn_test_5fzo4nqrnop03djdde1');

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$transaction = OmiseTransaction::retrieve('trxn_test_5fzo4nqrnop03djdde1');

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Transaction transaction = client.transactions().get("trxn_test_5fzo4nqrnop03djdde1");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var transaction = await client.Transactions.Get("trxn_test_5fzo4nqrnop03djdde1");

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

transaction, _ := client.Transactions().Get("trxn_test_5fzo4nqrnop03djdde1")

---

Try it out

Required - 1 fields

▼

id(Required)