---
title: "[v3.0] Retrieve Transaction Details"
method: GET
path: "/v3.0/transactions/{transaction_id}"
tags: ["Transactions"]
---

# \[v3.0\] Retrieve Transaction Details

`GET /v3.0/transactions/{transaction_id}`

## Request

- Base URL: `https://api.jvzoo.com`
- URL: `https://api.jvzoo.com/v3.0/transactions/{transaction_id}`
- Auth: HTTP basic

Returns the full details for a single transaction. The authenticated user must be the vendor (seller) for the requested transaction.

## Path parameters

- `transaction_id` string, required

## Response `200`

Success

- object
  - `meta` object
    - `status` MetaStatus
      - `http_status_code` integer
      - `code` integer
      - `message` string
      - `detail` string, nullable
    - `results_count` integer
    - `api_version` string
  - `results` Transaction[]
    - `transaction_id` string: The payKey identifier for the transaction
    - `sale_date` string: Date and time of the original sale in ISO 8601 format
    - `product_id` integer: The numeric product ID
    - `product_name` string: The product name at time of sale
    - `amount` string: Total transaction amount (2 decimal places)
    - `status` string: Transaction status (e.g., settled)
    - `customer` Customer
      - `email` string
      - `first_name` string
      - `last_name` string
    - `affiliate` Affiliate, nullable: The affiliate credited with the sale, or null if there was no affiliate on the transaction.
      - `id` integer: The affiliate's user ID
      - `display_name` string, nullable: The affiliate's display name
    - `tracking` Tracking: Tracking data associated with the transaction. Includes: - Vendor pass-through values from the checkout URL (`vtid`, `custom`). - Click attribution captured at the time of the click that led to the sale (UTM parameters, sub-IDs, ad-platform click IDs, and any other query-string parameters in `other_params`). All fields are nullable; when no click attribution was captured (e.g., direct traffic), the click attribution fields will all be null.
      - `vtid` string, nullable: Vendor Tracking ID (vtid) supplied by the vendor at checkout.
      - `custom` string, nullable: Vendor-supplied custom pass-through value from the checkout URL.
      - `tid` string, nullable: Affiliate-set tracking ID captured at click time.
      - `utm_source` string, nullable
      - `utm_medium` string, nullable
      - `utm_campaign` string, nullable
      - `utm_content` string, nullable
      - `utm_term` string, nullable
      - `sub_id1` string, nullable
      - `sub_id2` string, nullable
      - `sub_id3` string, nullable
      - `sub_id4` string, nullable
      - `sub_id5` string, nullable
      - `gclid` string, nullable: Google Ads click identifier.
      - `fbclid` string, nullable: Facebook/Meta Ads click identifier.
      - `msclkid` string, nullable: Microsoft Advertising (Bing) click identifier.
      - `ttclid` string, nullable: TikTok Ads click identifier.
      - `li_fat_id` string, nullable: LinkedIn first-party Ad Tracking identifier.
      - `twclid` string, nullable: X (formerly Twitter) Ads click identifier.
      - `yclid` string, nullable: Yandex click identifier.
      - `other_params` string, nullable: Any additional query string parameters captured at click time (raw string; format not guaranteed).
    - `payouts` Payouts: Financial breakdown of the transaction. All values are strings formatted to 2 decimal places.
      - `seller_earnings` string: Net earnings to the vendor after all fees and commissions
      - `affiliate_payout` string: Commission amount paid to the affiliate
      - `agent_payout` string: Commission amount paid to the sales agent
      - `jv_payout` string: Commission amount paid to JV partners
      - `jvzoo_fee` string: JVZoo platform fee
    - `refund` Refund: Refund details. All impact values are negative, representing amounts clawed back.
      - `refund_date` string: Date and time of the refund in ISO 8601 format
      - `refund_amount` string: Total amount refunded to the customer
      - `seller_refund_impact` string: Amount clawed back from the vendor (negative)
      - `affiliate_refund_impact` string: Amount clawed back from the affiliate (negative)
      - `agent_refund_impact` string: Amount clawed back from the agent (negative)
      - `jv_refund_impact` string: Amount clawed back from JV partners (negative)
      - `jvzoo_fee_adjustment` string: JVZoo fee adjustment on refund (negative)

## Other responses

- `404`: Transaction not found or user is not the vendor

---

[API](https://skmtc.dev/jvzoo/apis/jvzoo-api.md) · [All operations](https://skmtc.dev/jvzoo/apis/jvzoo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jvzoo/apis/jvzoo-api/revisions/2688a1f5ede5?raw)