> ## Documentation Index > Fetch the complete documentation index at: https://docs.sanfoundation.com/llms.txt > Use this file to discover all available pages before exploring further. # Get flight booking options > Retrieve seller options for a selected itinerary. Use a one-way itinerary ID or a selected return option ID. Keep the route, dates, country, and currency consistent with the search that produced it. Give the returned booking `link` to the person completing the purchase. Retrieving options does not reserve or buy a ticket. Links expire after one day; check `expires_at` and request fresh options when needed. ## OpenAPI ````yaml https://api.sanfoundation.com/openapi.json GET /v1/flights/{id}/bookings openapi: 3.0.0 info: title: SAN API description: >- Web data and context for agents, served by a network of miners running real browsers on residential connections. One resource per thing an agent asks for: search the web, read the news, find places, hotels and flights, and quote a symbol. Present an API key as `Authorization: Bearer san_...`. Every response is snake_case JSON and every error is `{ error: { code, message, param } }`. version: 0.0.1 contact: {} servers: [] security: [] tags: - name: web description: Web search - name: news description: News search - name: places description: Places search - name: hotels description: Stays search - name: flights description: Flight search - name: finance description: Quotes and charts - name: shopping description: Products and sellers - name: account description: Plan and remaining budget paths: /v1/flights/{id}/bookings: get: tags: - flights summary: Ways to book one itinerary description: >- Who sells this itinerary and for how much. Takes the `id` of a one-way itinerary or of a return option, with the same route and dates as the search that produced it. Each option carries a `link` that takes a person to the seller; the links stop working after a day, so ask again rather than storing them. operationId: FlightsController_bookings parameters: - name: id required: true in: path description: The `id` of a one-way itinerary or of a return option. schema: type: string example: san1.QkFEQ0FGRTAxMjM0NTY3ODk - name: country required: false in: query description: ISO 3166-1 alpha-2. Defaults to `us`. schema: type: string example: us - name: currency required: false in: query description: ISO 4217. Defaults to the currency of `country`. schema: type: string example: USD - name: return_date required: false in: query description: Required when the id came from a round trip. schema: example: '2026-10-19' type: string - name: departure_date required: true in: query schema: type: string example: '2026-10-15' - name: to required: true in: query schema: example: NRT type: string - name: from required: true in: query schema: type: string example: SIN responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/FlightBookingsResponseDto' '400': description: A parameter is missing, invalid or not recognized. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '401': description: Invalid API key. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '429': description: Monthly quota exhausted. Hard stop, no overage. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' '503': description: No miner and no fallback could serve the request. content: application/json: schema: $ref: '#/components/schemas/PublicErrorDto' security: - api_key: [] - x-api-key: [] components: schemas: FlightBookingsResponseDto: type: object properties: id: type: string format: uuid description: Id of this request. Quote it when reporting a problem. took_ms: type: number example: 1420 description: How long the request took, in milliseconds. request: type: object additionalProperties: true description: >- The parameters as accepted, after defaults and normalization. What the request actually ran with. example: query: coffee country: us page: 1 bookings: description: Ways to buy this itinerary, best first. type: array items: $ref: '#/components/schemas/FlightBookingDto' required: - id - took_ms - request - bookings PublicErrorDto: type: object properties: error: $ref: '#/components/schemas/PublicErrorBodyDto' required: - error FlightBookingDto: type: object properties: id: type: string example: 3f1c2d84-2b0e-4a8c-9f2a-8e1d4d6c0b11 provider: type: string example: Booking.com description: Who is selling. fare_name: type: string example: Airline description: The option's own label where the source prints one. price: type: number example: 616 currency: type: string example: USD baggage: example: - 1 free carry-on - 1st checked bag available for a fee type: array items: type: string conditions: example: - Separate tickets booked together type: array items: type: string link: type: string example: >- https://platform.example.com/flights/3f1c2d84-2b0e-4a8c-9f2a-8e1d4d6c0b11 description: >- Open this to book. It is a page that carries a person to the seller; the seller has no address of its own until someone books. expires_at: type: string example: '2026-09-12T04:20:00.000Z' description: After this the link is gone and a fresh one must be asked for. required: - id - provider - link - expires_at PublicErrorBodyDto: type: object properties: code: type: string enum: - unauthorized - missing_parameter - invalid_parameter - not_found - quota_exceeded - rate_limited - unavailable - expired - internal_error example: missing_parameter message: type: string example: Missing parameter `query`. param: type: string example: query description: The parameter at fault, when one parameter is at fault. required: - code - message securitySchemes: api_key: scheme: bearer bearerFormat: JWT type: http description: 'Public API key: `Authorization: Bearer san_...`.' x-api-key: type: apiKey in: header name: X-Api-Key description: The same public API key, as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.