Get Truemed Session

{
  "auth_holds": [],
  "captures": [
    {
      "amount_cents": 11850,
      "capture_id": "mrt_9001",
      "capture_time": "2026-06-30T16:00:00Z",
      "transaction_info": {
        "capture_time": "2026-06-30T16:00:00Z",
        "card_holder_name": "Alex Morgan",
        "last4": "4242",
        "merchant_descriptor": "MERCHANT SHOP",
        "network": "visa",
        "postal_code": "94105",
        "network_transaction_id": "visa_txn_123456789"
      }
    }
  ],
  "cart_info": {
    "cart_type": "all_eligible",
    "eligible_amount_cents": 11850,
    "ineligible_amount_cents": 0,
    "preapproved_amount_cents": 0
  },
  "created_at": "2026-06-30T15:00:00Z",
  "customer_email": "alex@example.com",
  "customer_name": "Alex Morgan",
  "is_testing": false,
  "order_items": [
    {
      "name": "Recovery Knee Brace",
      "price": 12000,
      "quantity": 1,
      "amount_details": {
        "additional_charges_details": [
          {
            "amount_cents": 850,
            "display_level": "tax",
            "name": "Tax"
          }
        ],
        "discounts_details": [
          {
            "amount_cents": 1000,
            "display_level": "line_item",
            "name": "WELCOME10"
          }
        ]
      },
      "eligible_amount_cents": 11850,
      "ineligible_amount_cents": 0,
      "item_id": "line_item_1",
      "preapproved_amount_cents": 0,
      "sku": "KNEE-BRACE-001"
    }
  ],
  "qualification_info": {
    "qualification_status": "approved",
    "is_already_qualified": false
  },
  "refunds": [],
  "truemed_session_id": "ts_01JZ7D4M3A8B9C0D1E2F3G4H5J",
  "user_id": "shopify_customer_7001",
  "metadata": "{\"shopify_order_id\":\"gid://shopify/Order/1001\"}"
}

Retrieve the full state of one Truemed session: its qualification status, order items, and every recorded capture, refund, and auth hold. This is the canonical lookup you reconcile against after a truemed_session.updated webhook fires — webhooks signal each qualification change, so there’s no need to poll.

Authentication

x-truemed-api-keystring

Sales channel API key for merchant server-to-server authentication

Path parameters

truemed_session_idstringRequired

The Truemed session ID from the URL path.

Response

Successful response

auth_holdslist of objects

Authorization holds recorded against this session, oldest first.

captureslist of objects

Merchant-reported captures recorded against this session.

cart_infoobject

Eligibility statement about the cart.

created_atdatetime

When the session was created.

customer_emailstring

The customer's email address, echoed from the create request.

customer_namestring

The customer's full name, echoed from the create request.

is_testingboolean

Whether this session was created in test mode.

order_itemslist of objects

Cart line items, echoed as a denormalized snapshot captured at session creation.

qualification_infoobject

Qualification statement about the shopper.

refundslist of objects

Refunds recorded against this session, oldest first.

truemed_session_idstring

The unique ID for this Truemed session.

user_idstring

Your stable identifier for this customer, echoed from the create request.

metadatastring or null

Opaque value echoed from session creation.

Errors

400

Bad Request Error

404

Not Found Error

405

Method Not Allowed Error

500

Internal Server Error

501

Not Implemented Error

$	curl https://dev-api.truemed.com/api/v2/truemed_sessions/truemed_session_id \
>	-H "x-truemed-api-key: <apiKey>"