---
title: "Get a transaction by ID"
method: GET
path: "/v1/transactions"
tags: ["Transactions"]
---

# Get a transaction by ID

`GET /v1/transactions`

Retrieve a single transaction by ID. View payment details, status, and associated order information.

## Query parameters

- `transaction_id` string, required

## Response `200`

Successfully retrieved transaction

- TransactionEntity
  - `id` string, required — Unique identifier for the object.
  - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
  - `object` string, required — String representing the object's type. Objects of the same type share the same value.
  - `amount` number, required — The transaction amount in cents. 1000 = $10.00
  - `amount_paid` number, nullable — The amount the customer paid in cents. 1000 = $10.00
  - `discount_amount` number, nullable — The discount amount in cents. 1000 = $10.00
  - `currency` string, required — Three-letter ISO currency code, in uppercase. Must be a supported currency.
  - `type` 'payment' | 'invoice', required — The type of transaction. payment(one time payments) and invoice(subscription)
  - `tax_country` string, nullable — The ISO alpha-2 country code where tax is collected.
  - `tax_amount` number, nullable — The sale tax amount in cents. 1000 = $10.00
  - `status` 'pending' | 'paid' | 'refunded' | 'partialRefund' | 'chargedBack' | 'uncollectible' | 'declined' | 'canceled' | 'void', required — Status of the transaction.
  - `refunded_amount` number, nullable — The amount that has been refunded in cents. 1000 = $10.00
  - `order` string, nullable — The order associated with the transaction.
  - `subscription` string, nullable — The subscription associated with the transaction.
  - `customer` string, nullable — The customer associated with the transaction.
  - `description` string — The description of the transaction.
  - `period_start` number — Start period for the invoice as timestamp
  - `period_end` number — End period for the invoice as timestamp
  - `created_at` number, required — Creation date of the order as timestamp

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/11305a63d3c9/schema)