> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Get Seat Maps > Seat map per segment for an offer; seats can only be selected when creating the order. ## Request contract * **Method and path:** GET /apis/v1/duffel/flights/seat-maps * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/duffel/flights/seat-maps](https://api.aisa.one/apis/v1/duffel/flights/seat-maps) * **after:** query; optional * **before:** query; optional * **limit:** query; optional * **offer\_id:** query; optional * **Runtime facts:** d0ae990bcd8ea1a75abd7e4a4e47260a24ab01e5c2b9d2fcc0366eae9f069f96 [Complete OpenAPI definition](https://aisa.one/docs/openapi/duffel-flights.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "get_duffel_seat_maps", "method": "GET", "path": "/apis/v1/duffel/flights/seat-maps", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "in": "query", "name": "after", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "before", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 200, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "offer_id", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "explicit_zero", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.005 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.005 * **Cost contract:** explicit\_zero * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/duffel-flights.json GET /apis/v1/duffel/flights/seat-maps openapi: 3.1.0 info: description: '' title: Duffel Flights version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-catalogs: duffel-flights: description: '' title: Duffel Flights x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: d0ae990bcd8ea1a75abd7e4a4e47260a24ab01e5c2b9d2fcc0366eae9f069f96 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-configured-paths: - /apis/v1/duffel/flights/offer-requests/create - /apis/v1/duffel/flights/offer-requests/list - /apis/v1/duffel/flights/offer-requests/{id} - /apis/v1/duffel/flights/offers/list - /apis/v1/duffel/flights/offers/{id} - /apis/v1/duffel/flights/order-cancellations/create - /apis/v1/duffel/flights/order-cancellations/{id} - /apis/v1/duffel/flights/order-cancellations/{id}/confirm - /apis/v1/duffel/flights/order-change-requests/create - /apis/v1/duffel/flights/order-change-requests/{id} - /apis/v1/duffel/flights/order-changes/create - /apis/v1/duffel/flights/orders/create - /apis/v1/duffel/flights/orders/hold-create - /apis/v1/duffel/flights/orders/{id} - /apis/v1/duffel/flights/seat-maps x-aisa-document: composer_version: '26' document_hash: sha256:7215160437f8ebdad941d4216401e4c44581391a83189741286cafd21885bd71 facts_hash: d0ae990bcd8ea1a75abd7e4a4e47260a24ab01e5c2b9d2fcc0366eae9f069f96 generator_version: '3' protocol_version: '1' response_pending: - method: POST operation_id: post_duffel_offer_requests_create path: /apis/v1/duffel/flights/offer-requests/create reason: public success response has no authoritative payload declaration statuses: - '200' - method: GET operation_id: get_duffel_offer_request path: /apis/v1/duffel/flights/offer-requests/{id} reason: public success response has no authoritative payload declaration statuses: - '200' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: duffel-flights servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/duffel/flights/seat-maps: get: tags: - duffel summary: Get Seat Maps description: >- Seat map per segment for an offer Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ. operationId: get_duffel_seat_maps parameters: - in: query name: after required: false schema: type: string - in: query name: before required: false schema: type: string - in: query name: limit required: false schema: maximum: 200 minimum: 1 type: integer - in: query name: offer_id required: false schema: type: string responses: 2XX: content: application/json: schema: properties: data: items: description: Each seat map is for a specific segment example: cabins: - aisles: 2 deck: 0 rows: - sections: - elements: - available_services: - id: ase_00009UhD4ongolulWAAA1A passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1A disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA1B passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1B disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA1C passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1C disclosures: [] name: '' type: seat - elements: - available_services: - id: ase_00009UhD4ongolulWAAA1D passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1D disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA1E passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1E disclosures: [] name: '' type: seat - available_services: [] designator: 1F disclosures: [] name: '' type: seat - available_services: [] designator: 1G disclosures: [] name: '' type: seat - elements: - available_services: - id: ase_00009UhD4ongolulWAAA1J passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1H disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA1K passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1J disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA1K passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '30.00' total_currency: GBP designator: 1K disclosures: [] name: '' type: seat - sections: - elements: - type: exit_row - elements: [] - elements: - type: exit_row - sections: - elements: - available_services: - id: ase_00009UhD4ongolulWAAA2A passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2A disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2B passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2B disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2C passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2C disclosures: [] name: '' type: seat - elements: - available_services: [] designator: 2D disclosures: [] name: '' type: seat - available_services: [] designator: 2E disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2F passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2F disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2G passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2G disclosures: [] name: '' type: seat - elements: - available_services: [] designator: 2H disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2J passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2J disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA2K passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '20.00' total_currency: GBP designator: 2K disclosures: [] name: '' type: seat - sections: - elements: - available_services: - id: ase_00009UhD4ongolulWAAA3A passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3A disclosures: [] name: '' type: seat - available_services: [] designator: 3B disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA3C passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3C disclosures: [] name: '' type: seat - elements: - available_services: - id: ase_00009UhD4ongolulWAAA3D passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3D disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA3E passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3E disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA3F passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3F disclosures: [] name: '' type: seat - available_services: [] designator: 3G disclosures: [] name: '' type: seat - elements: - available_services: - id: ase_00009UhD4ongolulWAAA3H passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3H disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA3J passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3J disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA3K passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 3K disclosures: [] name: '' type: seat - sections: - elements: - available_services: - id: ase_00009UhD4ongolulWAAA4A passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4A disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4B passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4B disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4C passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4C disclosures: [] name: '' type: seat - elements: - available_services: - id: ase_00009UhD4ongolulWAAA4D passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4D disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4E passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4E disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4F passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4F disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4G passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4G disclosures: [] name: '' type: seat - elements: - available_services: [] designator: 4H disclosures: [] name: '' type: seat - available_services: [] designator: 4J disclosures: [] name: '' type: seat - available_services: - id: ase_00009UhD4ongolulWAAA4K passenger_id: pas_00009hj8USM7Ncg31cAAA total_amount: '10.00' total_currency: GBP designator: 4K disclosures: [] name: '' type: seat - sections: - elements: - type: lavatory - elements: [] - elements: - type: lavatory - sections: - elements: - type: galley - elements: - type: galley - elements: - type: galley wings: first_row_index: 1 last_row_index: 2 id: sea_00003hthlsHZ8W4LxXjkzo segment_id: seg_00009htYpSCXrwaB9Dn456 slice_id: sli_00009htYpSCXrwaB9Dn123 properties: cabins: description: > The list of cabins in this seat map. Cabins are ordered by deck from lowest to highest, and then within each deck from the front to back of the aircraft. items: description: > A cabin is a physical section of an aircraft that passengers travel in. The cabin that a passenger travels in will depend on the fare they paid (for example an economy cabin versus a business class cabin). properties: aisles: description: > The number of aisles in this cabin. If this is set to `1`, each row of the cabin is split into two sections. If this is set to `2`, each row of the cabin is split into three sections. example: 1 maximum: 2 minimum: 1 type: integer cabin_class: description: >- The cabin class that the passenger will travel in on this segment enum: - first - business - premium_economy - economy example: economy type: - string - 'null' deck: description: > Level 0 is the main deck and level 1 is the upper deck above that, which is found on some large aircraft. example: 0 maximum: 1 minimum: 0 type: integer rows: description: > A list of rows in this cabin. Row sections are broken up by aisles. Rows are ordered from front to back of the aircraft. items: description: > A cabin row has one or more sections, each made up of elements. An element is something that takes up physical space such as a seat or an empty area. properties: sections: description: > A list of sections. Each row is divided into sections by one or more aisles. items: description: > A section within a row that contains a list of row elements. This corresponds to a left, middle, or right lengthwise section of the aircraft. properties: elements: description: The elements that make up this section items: oneOf: - description: > A seat for a passenger. If the `available_services` list is empty (which will be represented as an empty list : `[]`), the seat is unavailable. For display, all seats should be displayed with the same static width. properties: available_services: description: > Seats are considered a special kind of service. There will be at most one service per seat per passenger. A seat can only be booked for one passenger. If a seat has no available services (which will be represented as an empty list : `[]`) then it's unavailable. items: description: > A bookable seat is a special kind of service. Only one seat can be booked per passenger, per segment example: - id: ase_00009UhD4ongolulWd9123 passenger_id: pas_00009hj8USM7Ncg31cBCL total_amount: '40.00' total_currency: GBP properties: id: description: >- Duffel's unique identifier for the resource example: ase_00009UhD4ongolulWd9123 type: string passenger_id: description: The passenger that this seat is for example: pas_00009hj8USM7Ncg31cBCLL type: string total_amount: description: >- The total price of the seat, including taxes example: '15.00' type: string total_currency: description: > The currency of the `total_amount`, as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. If an offer or order is priced with balance, it matches your organisation's billing currency. If it is priced with card or airline credit, it is returned in the currency the airline charges in. If it is priced without payment methods and not using Duffel Content, it is returned in the agency point of sale currency. example: GBP format: ISO 4217 type: string required: - id - passenger_id - total_amount - total_currency title: Seat Service type: object type: array designator: description: > The designator used to uniquely identify the seat, usually made up of a row number and a column letter example: 14B type: string disclosures: description: > Each disclosure is text, in English, provided by the airline that describes the terms and conditions of this seat. We recommend showing this in your user interface to make sure that customers understand any restrictions and limitations. example: - Do not seat children in exit row seats - >- Do not seat passengers with special needs in exit row seats items: description: > An individual term, condition or restriction for this seat type: string type: array name: description: > A name which describes the type of seat, which you can display in your user interface to help customers to understand its features example: Exit row seat type: - string - 'null' type: description: The type of this element enum: - seat example: seat type: string required: - type - designator - disclosures - available_services title: Cabin Row Section Seat Element type: object - description: > A bassinet is a child's cradle. This element will be aligned with the corresponding seat in the following row. For display, this element should have the same width as a seat for proper alignment. properties: type: description: The type of this element enum: - bassinet example: bassinet type: string required: - type title: Cabin Row Section Bassinet Element type: object - description: > An empty space used for padding in some non-standard seat arrangements. For display, this element should have the same dimensions as a seat for proper alignment. properties: type: description: The type of this element enum: - empty example: empty type: string required: - type title: Cabin Row Section Empty Element type: object - description: > An exit row represents the extra wide space used to reach aircraft exits, and indicates the existence of an exit door. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - exit_row example: exit_row type: string required: - type title: Cabin Row Section Exit Row Element type: object - description: > A lavatory for use by passengers. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - lavatory example: lavatory type: string required: - type title: Cabin Row Section Lavatory Element type: object - description: > A galley is the compartment where food is cooked or prepared. These are conventionally marked with a teacup symbol. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - galley example: galley type: string required: - type title: Cabin Row Section Galley Element type: object - description: > A closet used for storage. These are conventionally marked with a clothes hanger symbol. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - closet example: closet type: string required: - type title: Cabin Row Section Closet Element type: object - description: > A set of stairs to another deck. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - stairs example: stairs type: string required: - type title: Cabin Row Section Stairs Element type: object - description: > A seat with restrictions on who can book it. For display, this element should ideally fill or shrink to available space in a row section. Displaying it with the same width as seat is also reasonable. properties: type: description: The type of this element enum: - restricted_seat_general example: restricted_seat_general type: string required: - type title: >- Cabin Row Section Restricted Seat Element type: object type: array required: - elements title: Cabin Row Section type: object type: array required: - sections title: Seat Map Cabin Row type: object type: array wings: description: > Where the wings of the aircraft are in relation to rows in the cabin. The numbers correspond to the indices of the first and the last row which are overwing. You can use this to draw a visual representation of the wings to help users get a better idea of what they will see outside their window. The indices are 0th-based and are for all rows, not just those that have seats. This is `null` when no rows of the cabin are overwing. example: first_row_index: 8 last_row_index: 12 properties: first_row_index: description: > The index of the first row which is overwing, starting from the front of the aircraft. example: 8 minimum: 0 type: integer last_row_index: description: > The index of the last row which is overwing, starting from the front of the aircraft. example: 12 minimum: 0 type: integer required: - first_row_index - last_row_index title: Wing Position type: - object - 'null' required: - deck - cabin_class - aisles - rows title: Seat Map Cabin type: object type: array id: description: Duffel's unique identifier for the resource example: sea_00003hthlsHZ8W4LxXjkzo type: string segment_id: description: Duffel's unique identifier for the resource example: xxx_00009hthhsUZ8W4LxQgkjo type: string slice_id: description: Duffel's unique identifier for the resource example: xxx_00009hthhsUZ8W4LxQgkjo type: string required: - id - slice_id - segment_id - cabins title: Seat map type: object type: array meta: properties: after: type: - string - 'null' before: type: string limit: type: number type: object required: - data type: object description: Successful HTTP response; fixed SDK accepts response.ok. default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.