> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.truemed.com/v-1/api-reference/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.truemed.com/_mcp/server. # API reference > REST API reference for Truemed - payment sessions, payment tokens, qualification sessions, product catalog, disputes, and reconciliation. The Truemed API is a REST API served from `https://api.truemed.com` (production) and `https://dev-api.truemed.com` (development). Requests and responses use JSON, and every endpoint is authenticated with your API key. ## Before you call the API * [Before you begin](/guides/setup/api/payment-sessions/before-you-begin) covers API keys, environments, and test data. * [Accept your first payment](/guides/setup/api/payment-sessions/accept-your-first-payment) walks through a full checkout end to end. * [Webhooks](/guides/setup/api/resources/webhooks) explains how event delivery, retries, and signatures work. ## OpenAPI spec The full spec is available at [`/openapi.json`](/openapi.json) — use it with Postman, SDK generators, or AI agents. Questions? Email [api-support@truemed.com](mailto:api-support@truemed.com). > REST API reference for Truemed - payment sessions, payment tokens, qualification sessions, product catalog, disputes, and reconciliation. ## API Docs - API Reference > Payment Sessions [Create Payment Session](https://developers.truemed.com/v-1/api-reference/payment-sessions/create-payment-session.md) - API Reference > Payment Sessions [Get Payment Status](https://developers.truemed.com/v-1/api-reference/payment-sessions/retrieve-payment-session.md) - API Reference > Payment Sessions [List Payment Sessions](https://developers.truemed.com/v-1/api-reference/payment-sessions/list-payment-session.md) - API Reference > Payment Sessions [Capture Session](https://developers.truemed.com/v-1/api-reference/payment-sessions/capture-payment-session.md) - API Reference > Payment Sessions [Cancel Payment Session](https://developers.truemed.com/v-1/api-reference/payment-sessions/cancel-payment-session.md) - API Reference > Payment Sessions [Void Session](https://developers.truemed.com/v-1/api-reference/payment-sessions/void-payment-session.md) - API Reference > Payment Sessions [Create Refund](https://developers.truemed.com/v-1/api-reference/payment-sessions/create-refund.md) - API Reference > Payment Sessions [Payment Session Capture Failed Webhook](https://developers.truemed.com/v-1/api-reference/payment-sessions/payment-session-capture-failed-webhook.md) - API Reference > Payment Sessions [Payment Session Complete Webhook](https://developers.truemed.com/v-1/api-reference/payment-sessions/payment-session-completed-webhook.md) - API Reference > Payment Tokens [Create Payment Token](https://developers.truemed.com/v-1/api-reference/payment-tokens/create-payment-token.md) - API Reference > Payment Tokens [Retrieve Payment Token](https://developers.truemed.com/v-1/api-reference/payment-tokens/retrieve-payment-token.md) - API Reference > Payment Tokens [List Payment Tokens](https://developers.truemed.com/v-1/api-reference/payment-tokens/list-payment-token.md) - API Reference > Payment Tokens [Update Payment Token](https://developers.truemed.com/v-1/api-reference/payment-tokens/update-payment-token.md) - API Reference > Payment Tokens [Delete Payment Token](https://developers.truemed.com/v-1/api-reference/payment-tokens/delete-payment-token.md) - API Reference > Payment Tokens [Retrieve Provision Token Request](https://developers.truemed.com/v-1/api-reference/payment-tokens/retrieve-payment-token-provision-request.md) - API Reference > Payment Tokens [Payment Token Updated Webhook](https://developers.truemed.com/v-1/api-reference/payment-tokens/payment-token-updated-webhook.md) - API Reference > Disputes [Get Dispute](https://developers.truemed.com/v-1/api-reference/disputes/retrieve-dispute.md) - API Reference > Disputes [List Disputes](https://developers.truemed.com/v-1/api-reference/disputes/list-dispute.md) - API Reference > Disputes [Accept Dispute](https://developers.truemed.com/v-1/api-reference/disputes/accept-dispute.md) - API Reference > Disputes [Create Dispute Counter](https://developers.truemed.com/v-1/api-reference/disputes/create-dispute-counter.md) - API Reference > Disputes [Update Dispute Counter](https://developers.truemed.com/v-1/api-reference/disputes/update-dispute-counter.md) - API Reference > Disputes [Submit Dispute Counter](https://developers.truemed.com/v-1/api-reference/disputes/submit-dispute-counter.md) - API Reference > Disputes [Withdraw Dispute Counter](https://developers.truemed.com/v-1/api-reference/disputes/withdraw-dispute-counter.md) - API Reference > Disputes [Update Dispute Metadata](https://developers.truemed.com/v-1/api-reference/disputes/update-dispute-metadata.md) - API Reference > Disputes [Dispute Closed Webhook](https://developers.truemed.com/v-1/api-reference/disputes/dispute-closed-webhook.md) - API Reference > Disputes [Dispute Created Webhook](https://developers.truemed.com/v-1/api-reference/disputes/dispute-created-webhook.md) - API Reference > Disputes [Dispute Updated Webhook](https://developers.truemed.com/v-1/api-reference/disputes/dispute-updated-webhook.md) - API Reference > Qualification Sessions [Get Qualification Session Details](https://developers.truemed.com/v-1/api-reference/qualification-sessions/retrieve-qualification-session.md) - API Reference > Qualification Sessions [List Qualification Sessions](https://developers.truemed.com/v-1/api-reference/qualification-sessions/list-qualification-session.md) - API Reference > Qualification Sessions [Update Qualification Session](https://developers.truemed.com/v-1/api-reference/qualification-sessions/update-qualification-session.md) - API Reference > Qualification Sessions [Qualification Session Complete Webhook](https://developers.truemed.com/v-1/api-reference/qualification-sessions/qualification-status-updated-webhook.md) - API Reference > Product Catalog [List Catalog Items](https://developers.truemed.com/v-1/api-reference/product-catalog/list-catalog-items.md) - API Reference > Product Catalog [Truemed Checkout Method](https://developers.truemed.com/v-1/api-reference/product-catalog/truemed-checkout-method.md) - API Reference > Product Catalog [Create Catalog Item](https://developers.truemed.com/v-1/api-reference/product-catalog/create-item.md) - API Reference > Product Catalog [Update Catalog Item](https://developers.truemed.com/v-1/api-reference/product-catalog/update-item.md) - API Reference > Product Catalog [Get Catalog Item Details](https://developers.truemed.com/v-1/api-reference/product-catalog/get-item-detail.md) - API Reference > Product Catalog [Item Eligibility Updated Webhook](https://developers.truemed.com/v-1/api-reference/product-catalog/item-eligibility-updated-webhook.md) - API Reference > Eligibility [Retrieve Catalog Eligibility](https://developers.truemed.com/v-1/api-reference/eligibility/retrieve-catalog-eligibility.md) - API Reference > Eligibility [Retrieve Provision Request Eligibility](https://developers.truemed.com/v-1/api-reference/eligibility/retrieve-provision-request-eligibility.md) - API Reference > Eligibility [Retrieve Token Eligibility](https://developers.truemed.com/v-1/api-reference/eligibility/retrieve-token-eligibility.md) - API Reference > Files [Create File](https://developers.truemed.com/v-1/api-reference/files/create-file.md) - API Reference > Files [Get File](https://developers.truemed.com/v-1/api-reference/files/retrieve-file.md) - API Reference > Files [List Files](https://developers.truemed.com/v-1/api-reference/files/list-file.md) - API Reference > Reconciliations [List Reconciliation Payouts](https://developers.truemed.com/v-1/api-reference/reconciliations/list-payout-reconciliation.md) - API Reference > Reconciliations [List Reconciliation Transactions](https://developers.truemed.com/v-1/api-reference/reconciliations/list-transaction-reconciliation.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developers.truemed.com/openapi.json) - [OpenAPI YAML](https://developers.truemed.com/openapi.yaml)