> ## Documentation Index > Fetch the complete documentation index at: https://mcp.theoryofevolution.com.au/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Voucher Details in JSON Format ## OpenAPI ````yaml /openapi/agent-reseller-api.mintlify.json get /apiv1/voucher/{orderId}.json openapi: 3.0.0 info: title: TravelDesk Agent API contact: name: API Support email: api@websitetravel.com version: '1.0' description: >- TravelDesk Agent (Reseller) API. ## Rate limiting The quota is applied **per Agent Branch key** — the per-branch client id/secret pair — not per account, per host, or per integration. Standard branches get **200 calls per minute**; upgraded branches get **900**. That budget is shared across everything the branch does: availability refreshes, background sweeps, customer-facing pricing, and quote or booking creation. Two consequences worth designing around: - A background sweep can starve customer-facing traffic for the same branch. Give live requests priority over refresh work, and cap the concurrency of any bulk job. - Cooldowns after a `429` must be keyed per branch. Keying them by host throttles every branch at once, because they all share `tdms.websitetravel.com`. Prefer endpoints that answer for a whole product in one request — `/apiv1/checkAvailabilityProduct` over one `/apiv1/checkavailabilityrange` call per fareprice — since the saving is measured against this quota. ## Dates Most endpoints take and return `DD-MON-YYYY` (`29-JUL-2026`). `/apiv1/checkAvailabilityProduct` returns ISO `YYYY-MM-DD` keys in `dates`. Parse both. ## Pricing Accommodation is dynamically priced — rates move between individual dates, not just between seasons — so never cache one rate per fareprice and reuse it across a range. Nett tracks RRP at a fixed commission ratio per fareprice, because changing commission requires a new `productPricesDetailsId`; that makes nett safe to derive from RRP rather than store. servers: - url: https://tdms.websitetravel.com description: Production Server - url: https://tdmstest03.websitetravel.com description: Test Server - url: http://tdms.localhost description: Development Server security: [] tags: - name: Authentication - name: Products - name: Availability and Pricing - Booking system based Live Availability - name: Availability and Pricing - Siteminder Live Availability - name: Availability and Pricing - Cached Availability and Live pricing - name: Availability and Pricing - Package Availability - name: Availability and Pricing - Check Availability via mail to supplier - name: Order Placement - name: Post Order Management - name: Accommodation - name: Reports paths: /apiv1/voucher/{orderId}.json: get: tags: - Post Order Management summary: Get Voucher Details in JSON Format operationId: step1_getVoucherDetails parameters: - name: orderId in: path required: true schema: type: integer pattern: \d+ responses: '200': description: Returned when successful content: application/json: schema: description: Voucher Object properties: agent: description: Agent object properties: name: description: Selling agent name type: string address1: description: Address line one type: string address2: description: Address line two type: string state: description: State type: string postcode: description: Postcode type: string country: description: Country of selling agent type: string phone: description: Phone number type: string email: description: Email type: string website: description: Website type: string logo: description: URL to logo of agent type: string type: object agentUser: description: Agent User object properties: name: description: Selling Agent staff member's name type: string email: description: Email type: string type: object purchaseDate: description: Purchase date in ISO-8601 format type: string customerEmail: description: Email of main customer type: string bookingReference: description: Order booking reference type: string products: description: Array of product objects type: array items: description: Details of product properties: voucherNumber: description: Voucher Number type: string qty: description: Quantity ordered type: integer name: description: Product name type: string fareName: description: Name of fare sold for product type: string depositOnly: description: Whether product is a deposit only fare type: boolean remainingAmount: description: >- Remaining amount to pay. Only applicable if depositOnly = true type: number format: float instructions: description: Fare instructions type: string supplier: description: Supplier object properties: freePhone: description: Free phone number type: string suburb: description: Suburb type: string name: description: Name type: string address1: description: Address line one type: string address2: description: Address line two type: string state: description: State type: string postcode: description: Postcode type: string country: description: Country of product supplier type: string phone: description: Phone number type: string email: description: Email type: string type: object redeemers: description: Array of redeemer (customer) objects type: array items: description: Details of redeemer properties: qty: description: Quantity applied to this redeemer type: integer bookingDetails: description: Array of booking detail objects type: array items: description: Details of booking properties: type: description: Type of booking detail type: string travelDate: description: Date booked in ISO-8601 format type: string fareValidFrom: description: ISO-8601 date of when fare is valid from type: string fareValidUntil: description: >- ISO-8601 date of when fare is valid until type: string commencementTime: description: Time product/fare commences type: string pickupTime: description: Pickup time free-text type: string pickupLocation: description: Pickup location free-text type: string optionalFields: description: >- Custom booking field answers for this redeemer and product. Discover the available fields via GET /apiv1/bookingdetails/{productPricesDetailsId}. Each item must be {optionalFieldId, fieldText}. TDMS silently ignores unknown value keys such as fieldValue or optionalFieldValue — using the wrong key means the order still succeeds but the booking arrives with additionalFields empty on the supplier side. type: array items: description: Details of optional field properties: name: description: Optional field name type: string value: description: Value entered by customer type: string type: object eBookingReferenceId: description: Internal booking Id type: string detailComment: description: >- Comments applied to this specific booking detail type: string comments: description: Comments applied to the entire voucher type: string apiProviderReferenceId: description: >- Reference Id given if product is booked via third-party type: string apiProviderDetails: description: Details from API provider type: array items: type: string ticketNumber: description: >- Secondary reference Id given if product is booked via third-party type: string levy: description: Levy type: number format: float levyDescription: description: Levy Description type: string fareCurrencyLevy: description: Fare Currency Levy type: number format: float cancellationFeePolicyDescription: description: Cancellation Fee Policy Description type: string cancellationFeePolicyRules: description: Cancellation Fee Policy Rules type: array items: type: string type: object name: description: Redeemer (customer) name type: string phone: description: Redeemer phone type: string postcode: description: Postcode type: string title: description: Redeemer title (Mr, Mrs, etc) type: string dateOfBirth: description: Redeemer date of birth type: string email: description: Redeemer email address type: string country: description: Redeemer country type: string type: object tripId: description: Trip id type: integer tourCode: description: Tour code type: string startLocation: description: Start location type: string endLocation: description: End location type: string type: object expires: description: Expiry date of order in ISO-8601 format type: string termsAndConditions: description: HTML string of Terms and Conditions type: string termsAndConditionsChecklist: description: HTML string of Terms and Conditions checklist type: string customerOrderPageUrl: description: HTML string of Customer Order page url type: string type: object '401': description: Not allowed to access order. '404': description: Order not found. '500': description: Internal error. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.