{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Transfer Search"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"transfer-search","__idx":0},"children":["Transfer Search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfer search endpoints allow you to find available transfer vehicles between two points at a given time. The search"," ","returns a list of vehicle offers with pricing, rules, and cancellation policies; each offer is identified by the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," pair used in the subsequent order step."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"search-transfers","__idx":1},"children":["Search Transfers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search for available transfer vehicles for the specified route, time, and passenger count."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /transfer/search\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer YOUR_ACCESS_TOKEN\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"coordinate-source-strongly-recommended","__idx":4},"children":["Coordinate Source (Strongly Recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}," coordinates from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/endpoints/locations"},"children":["Locations"]}," endpoints (place search + place detail)"," ","rather than your own geocoding. Transfer suppliers map the given coordinates onto their own service regions; raw"," ","coordinates that fall slightly outside a supplier's region are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["silently dropped"]}," from the results. The same search"," ","therefore returns noticeably more vehicles when the coordinates come from a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/locations"]}," point of interest (airport,"," ","hotel, district) than from a nearby raw coordinate."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":5},"children":["Request Body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trip type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneway"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["round"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pickup point"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.lat"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latitude coordinate (-90 to 90)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.lon"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Longitude coordinate (-180 to 180)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable name of the pickup point"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropoff"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dropoff point (same structure as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pickup date and time (RFC 3339 format with timezone). Must be in the future"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnPickupTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return leg pickup time. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["round"]},"; must be after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupTime"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengerCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of passengers (minimum 1)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agency commission to add on top of the net price"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commission type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["percentage"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fixed"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission.percentage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commission percentage (0-100). Required when type is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["percentage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission.fixed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fixed commission as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{amount, currency}"]},". Required when type is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fixed"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":6},"children":["Example Request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The dates in the examples are illustrative; use a pickup time in the future when you send your own request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/search \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -d '{\n    \"type\": \"oneway\",\n    \"pickup\": {\"lat\": 41.276146, \"lon\": 28.728735, \"name\": \"Istanbul Airport (IST)\"},\n    \"dropoff\": {\"lat\": 41.037003, \"lon\": 28.985092, \"name\": \"Taksim Square\"},\n    \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n    \"passengerCount\": 2,\n    \"commission\": {\"type\": \"percentage\", \"percentage\": 10}\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":7},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (200 OK):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"searchId\": \"0ba0fea9-1e98-43ce-a69b-e895e2bc68a6\",\n  \"products\": [\n    {\n      \"code\": \"9972a93a-707e-403e-928e-cbb68a65584f\",\n      \"appointment\": {\n        \"pickup\": {\n          \"lat\": 41.276146,\n          \"lon\": 28.728735,\n          \"name\": \"Istanbul Airport (IST)\"\n        },\n        \"dropoff\": {\n          \"lat\": 41.037003,\n          \"lon\": 28.985092,\n          \"name\": \"Taksim Square\"\n        },\n        \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n        \"passengerCount\": 2\n      },\n      \"onewayDistance\": 41662,\n      \"onewayDuration\": 2727,\n      \"vehicle\": {\n        \"name\": \"Minivan\",\n        \"seatCount\": 6,\n        \"baggageCount\": 6,\n        \"image\": \"https://cdn.example.com/assets/images/van.png\"\n      },\n      \"pricing\": {\n        \"currency\": \"TRY\",\n        \"fees\": [\n          {\n            \"amount\": 132000,\n            \"currency\": \"TRY\",\n            \"type\": \"oneway\",\n            \"charge\": \"advance\",\n            \"description\": \"Outbound Trip Amount\"\n          },\n          {\n            \"amount\": 13200,\n            \"currency\": \"TRY\",\n            \"type\": \"commission\",\n            \"charge\": \"advance\",\n            \"description\": \"commission\"\n          }\n        ],\n        \"vendorTotal\": {\n          \"amount\": 0,\n          \"currency\": \"TRY\"\n        },\n        \"paymentTotal\": {\n          \"amount\": 145200,\n          \"currency\": \"TRY\"\n        },\n        \"discountTotal\": {\n          \"amount\": 0,\n          \"currency\": \"TRY\"\n        },\n        \"total\": {\n          \"amount\": 145200,\n          \"currency\": \"TRY\"\n        }\n      },\n      \"rules\": [\n        {\n          \"type\": \"freeCancellation\",\n          \"description\": \"Free Cancellation\"\n        },\n        {\n          \"type\": \"waitForFree\",\n          \"description\": \"First 15 minutes of waiting free\"\n        },\n        {\n          \"type\": \"safeTripWithInvoice\",\n          \"description\": \"Safe trip with invoice\"\n        }\n      ],\n      \"cancellationPolicies\": [\n        {\n          \"type\": \"freeCancel\",\n          \"until\": \"2027-06-15T09:00:00+03:00\",\n          \"description\": \"You can cancel your transfer free of charge up to 1 hour before departure.\"\n        }\n      ]\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-fields","__idx":8},"children":["Response Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search session identifier, used when creating the order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Available vehicle offers"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"product-fields","__idx":9},"children":["Product Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer code, used together with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}," when creating the order"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["appointment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The trip as understood by the supplier (points, times, passenger count)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onewayDistance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outbound trip distance in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["meters"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onewayDuration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outbound trip duration in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["seconds"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnDistance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return trip distance in meters (round trips only)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnDuration"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return trip duration in seconds (round trips only)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vehicle"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vehicle name, seat count, baggage count, and image"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pricing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price breakdown (see below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rules"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service rules as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{type, description}"]}," items"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellationPolicies"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancellation policy windows as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{type, until, description}"]}," items"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"pricing-fields","__idx":10},"children":["Pricing Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All amounts are in minor units (kuruş for TRY)."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency of the breakdown"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fees"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price line items: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneway"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return"]}," trip amounts, plus a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commission"]}," line when an agency commission was requested"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorTotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount payable to the supplier at the vehicle (currently always paid in advance)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentTotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount that will be charged at the payment step"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["discountTotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total discount applied"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Grand total including commission"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"round-trip-search","__idx":11},"children":["Round Trip Search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["round"]}," and provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnPickupTime"]},". The response contains the additional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnDistance"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnDuration"]}," fields and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["return"]}," fee line:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/search \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -d '{\n    \"type\": \"round\",\n    \"pickup\": {\"lat\": 41.276146, \"lon\": 28.728735, \"name\": \"Istanbul Airport (IST)\"},\n    \"dropoff\": {\"lat\": 41.037003, \"lon\": 28.985092, \"name\": \"Taksim Square\"},\n    \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n    \"returnPickupTime\": \"2027-06-20T14:00:00+03:00\",\n    \"passengerCount\": 2\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"searchId\": \"9635f52b-e0f9-4b5e-8b23-0986be44b88b\",\n  \"products\": [\n    {\n      \"code\": \"e96d7154-e0c8-45c6-81c6-54db5506bfaf\",\n      \"appointment\": {\n        \"pickup\": {\n          \"lat\": 41.276146,\n          \"lon\": 28.728735,\n          \"name\": \"Istanbul Airport (IST)\"\n        },\n        \"dropoff\": {\n          \"lat\": 41.037003,\n          \"lon\": 28.985092,\n          \"name\": \"Taksim Square\"\n        },\n        \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n        \"returnPickupTime\": \"2027-06-20T14:00:00+03:00\",\n        \"passengerCount\": 2\n      },\n      \"onewayDistance\": 41662,\n      \"returnDistance\": 41662,\n      \"onewayDuration\": 2727,\n      \"returnDuration\": 2727,\n      \"pricing\": {\n        \"currency\": \"TRY\",\n        \"fees\": [\n          {\n            \"amount\": 132000,\n            \"currency\": \"TRY\",\n            \"type\": \"oneway\",\n            \"charge\": \"advance\",\n            \"description\": \"Outbound Trip Amount\"\n          },\n          {\n            \"amount\": 132000,\n            \"currency\": \"TRY\",\n            \"type\": \"return\",\n            \"charge\": \"advance\",\n            \"description\": \"Return Trip Amount\"\n          }\n        ]\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The example above is trimmed to the round-trip-specific fields; the full product structure is identical to the one-way"," ","response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-offer-detail","__idx":12},"children":["Get Offer Detail"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve a single offer from an earlier search by its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]},". Useful for re-rendering an offer the user"," ","selected without keeping the whole search response in your session."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":13},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /transfer/search/{searchId}/{code}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-1","__idx":14},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameters","__idx":15},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search identifier from the search"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer code from the search"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-1","__idx":16},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://api.pro.yolcu360.com/api/v1/transfer/search/0ba0fea9-1e98-43ce-a69b-e895e2bc68a6/9972a93a-707e-403e-928e-cbb68a65584f \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-1","__idx":17},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (200 OK):"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns a single product object with exactly the same structure as an item of the search response's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," array."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"offer-expiration","__idx":18},"children":["Offer Expiration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search offers are valid for roughly ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30 minutes"]},". Requesting an expired or unknown offer returns:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 8003,\n  \"description\": \"Transfer product not found or expired\",\n  \"details\": \"The search result was not found or has expired, please search again.\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run a new search and present fresh offers in that case."]}]},"headings":[{"value":"Transfer Search","id":"transfer-search","depth":1},{"value":"Search Transfers","id":"search-transfers","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Authentication","id":"authentication","depth":3},{"value":"Coordinate Source (Strongly Recommended)","id":"coordinate-source-strongly-recommended","depth":3},{"value":"Request Body","id":"request-body","depth":3},{"value":"Example Request","id":"example-request","depth":3},{"value":"Response","id":"response","depth":3},{"value":"Response Fields","id":"response-fields","depth":3},{"value":"Product Fields","id":"product-fields","depth":4},{"value":"Pricing Fields","id":"pricing-fields","depth":4},{"value":"Round Trip Search","id":"round-trip-search","depth":3},{"value":"Get Offer Detail","id":"get-offer-detail","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Authentication","id":"authentication-1","depth":3},{"value":"Path Parameters","id":"path-parameters","depth":3},{"value":"Example Request","id":"example-request-1","depth":3},{"value":"Response","id":"response-1","depth":3},{"value":"Offer Expiration","id":"offer-expiration","depth":3}],"frontmatter":{"seo":{"title":"Transfer Search"}},"lastModified":"2026-10-01T06:30:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/endpoints/transfer-search","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}