List Qualification Sessions

import requests
url = "https://dev-api.truemed.com/api/v1/qualification_sessions"
payload = {}
headers = {
    "x-truemed-api-key": "<apiKey>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "qualification_sessions": [
    {
      "qualification_session_id": "qs_8f3b2a1c-4d5e-4f6a-9b7c-123456789abc",
      "status": "pending",
      "charge_group_created_at": "2024-01-15T09:30:00Z",
      "created_at": "2024-01-15T09:30:00Z",
      "customer_status": "active",
      "eligible_amount": 150.75,
      "email": "jane.doe@example.com",
      "expires_at": "2024-07-15T09:30:00Z",
      "fee": 15,
      "lmn_reviewed_at": "2024-01-20T14:00:00Z",
      "session_type": "standard",
      "skus_param": "SKU12345,SKU67890",
      "source": "checkout_page",
      "stripe_invoice_id": "in_1J2Y3Z4A5B6C7D8E9F0G",
      "stripe_invoice_number": "INV-20240115-0001",
      "stripe_invoice_paid_at": "2024-01-16T10:00:00Z",
      "user_business_id": "BUS-987654321",
      "user_id": "user_1234567890abcdef",
      "user_name": "Jane Doe"
    }
  ],
  "pagination": {
    "count": 1,
    "current_page": 1,
    "last_page": 1,
    "page_size": 1
  }
}

Returns a paginated view of all Qualification Sessions associated with the API key used in the request header, sorted by their created_at date. Optional search fields are provided to aid in finding the session or sessions associated with a given user.

Request Notes

Query Params:

status (Optional): filter Qualification Sessions by status. The supported values and their meanings are listed in the parameter’s description below.
page (Optional): int - the page to retrieve, defaults to 1. 30 entries are returned per page.

Response Notes

Bad Request

HTTP Status: 400

If a field is missing or the request otherwise can’t be processed, we’ll return a 400 with the following fields:

error: Can be one of:
- ValidationError: invalid request
message: Details on how the request was invalid

Returns a paginated view of all Qualification Sessions associated with the API key used in the request header, sorted by their `created_at` date. Optional search fields are provided to aid in finding the session or sessions associated with a given user. ## Request Notes Query Params: - `status` (Optional): filter Qualification Sessions by status. The supported values and their meanings are listed in the parameter's description below. - `page` (Optional): int - the page to retrieve, defaults to 1. 30 entries are returned per page. ## Response Notes ### Bad Request HTTP Status: 400 If a field is missing or the request otherwise can't be processed, we'll return a 400 with the following fields: - **error**: Can be one of: - `ValidationError`: invalid request - **message**: Details on how the request was invalid

Authentication

x-truemed-api-keystring

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

Query parameters

pageintegerOptional

Optional field indicating which page to access. Defaults to 1.

page_sizeintegerOptional

Optional field indicating the number of records per page. Defaults to 30.

user_idstringOptional

An optional user_id to search for.

statusstringOptional

An optional filter to only return sessions with the given status. One of:

pending — The session was created; the shopper hasn’t completed the survey yet.
processing — The shopper completed the survey and it is under review.
approved — The shopper holds a valid Letter of Medical Necessity covering the items in this order.
rejected — The shopper is ineligible for a Letter of Medical Necessity for the items in this order.

An optional filter to only return sessions with the given status. One of: - `pending` — The session was created; the shopper hasn't completed the survey yet. - `processing` — The shopper completed the survey and it is under review. - `approved` — The shopper holds a valid Letter of Medical Necessity covering the items in this order. - `rejected` — The shopper is ineligible for a Letter of Medical Necessity for the items in this order.

expires_atdatetimeOptional

Filter by expiration date (YYYY-MM-DD format)

searchstringOptional

Search across user name, email, user_business_id, utm, and external_user_id fields.

Response

Successful response

qualification_sessionslist of objects

An array of qualification_session objects.

paginationobject or null

A pagination object with information about the current page, page size, total count, and last page.

Errors

400

Bad Request Error

404

Not Found Error

405

Method Not Allowed Error

500

Internal Server Error

501

Not Implemented Error