---
updatedAt: 2025-12-28T21:51:27.000Z
agentTools:
  projectIndex: https://docs.aerocrs.com/llms.txt
---

# getAncillaries

This method will provide ancillaries available for a flight

## Request parameters

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Parameter
      </th>

      <th style={{ textAlign: "left" }}>
        Type
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        flightid
      </td>

      <td style={{ textAlign: "left" }}>
        Number\*
      </td>

      <td style={{ textAlign: "left" }}>
        Flight internal code
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        bookingid
      </td>

      <td style={{ textAlign: "left" }}>
        Number\*
      </td>

      <td style={{ textAlign: "left" }}>
        Booking id received from createBooking
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        currency
      </td>

      <td style={{ textAlign: "left" }}>
        String\*
      </td>

      <td style={{ textAlign: "left" }}>
        Currency ISO code
      </td>
    </tr>
  </tbody>
</Table>

> ❗️ \* Mandatory parameters

## Response

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Type
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        name
      </td>

      <td>
        String
      </td>

      <td>
        Ancillary name
      </td>
    </tr>

    <tr>
      <td>
        description
      </td>

      <td>
        String
      </td>

      <td>
        Ancillary description
      </td>
    </tr>

    <tr>
      <td>
        image
      </td>

      <td>
        Link
      </td>

      <td>
        Link to image
      </td>
    </tr>

    <tr>
      <td>
        ssrcode
      </td>

      <td>
        String
      </td>

      <td>
        SSR code
      </td>
    </tr>

    <tr>
      <td>
        items
      </td>

      <td>
        Array
      </td>

      <td>
        List of ancillary items and their information
      </td>
    </tr>

    <tr>
      <td>
        itemid
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary Number (to use on createAncillary method)
      </td>
    </tr>

    <tr>
      <td>
        itemname
      </td>

      <td>
        String
      </td>

      <td>
        Ancillary-item name
      </td>
    </tr>

    <tr>
      <td>
        quantityforitem
      </td>

      <td>
        Number
      </td>

      <td>
        The factor of quantity taken from the total quantity allowed on the ancillary
      </td>
    </tr>

    <tr>
      <td>
        fare
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item fare
      </td>
    </tr>

    <tr>
      <td>
        tax1
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item tax
      </td>
    </tr>

    <tr>
      <td>
        tax2
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item tax
      </td>
    </tr>

    <tr>
      <td>
        tax3
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item tax
      </td>
    </tr>

    <tr>
      <td>
        tax4
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item tax
      </td>
    </tr>

    <tr>
      <td>
        vat
      </td>

      <td>
        Number
      </td>

      <td>
        Ancillary-item vat
      </td>
    </tr>
  </tbody>
</Table>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "aerocrs-v5",
    "version": "5.0"
  },
  "servers": [
    {
      "url": "https://api.aerocrs.com/v5"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "auth_id"
      },
      "sec1": {
        "type": "apiKey",
        "in": "header",
        "name": "auth_password"
      }
    }
  },
  "security": [
    {
      "sec0": [],
      "sec1": []
    }
  ],
  "paths": {
    "/getAncillaries": {
      "post": {
        "summary": "getAncillaries",
        "description": "This method will provide ancillaries available for a flight",
        "operationId": "getancillaries",
        "parameters": [
          {
            "name": "auth_id",
            "in": "header",
            "description": "ID provided to you by AeroCRS",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "auth_password",
            "in": "header",
            "description": "Password provided to you by AeroCRS",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "RAW_BODY"
                ],
                "properties": {
                  "RAW_BODY": {
                    "type": "string",
                    "description": "The method accepts the XML / JSON input as POST, response format will be according to the sent format. You can try JSON, put the post in the following input and click \"Try It\"",
                    "format": "json"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "aerocrs": {
                      "parms": {
                        "bookingid": 36109690,
                        "flightid": 10953299,
                        "currency": "USD"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "JSON": {
                    "value": "{\n    \"aerocrs\": {\n        \"success\": true,\n        \"ancillaries\": {\n            \"ancillary\": [\n                {\n                    \"name\": \"/ Pets / #\",\n                    \"description\": \"Dog / or Cat &#43;$\",\n                    \"image\": \"https://storage.aerocrs.com/288/system/1.png\",\n                    \"ssrcode\": \"\",\n                    \"icon\": \"fa-dog\",\n                    \"items\": [\n                        {\n                            \"itemid\": \"4712\",\n                            \"itemname\": \"Dog $ or /  Cat # \",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \"50.0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        }\n                    ]\n                },\n                {\n                    \"name\": \"Sport Equipment\",\n                    \"description\": \"sweat and more\",\n                    \"image\": \"https://storage.aerocrs.com/288/system/43.png\",\n                    \"ssrcode\": \"\",\n                    \"icon\": \"fa-biking\",\n                    \"items\": [\n                        {\n                            \"itemid\": \"4771\",\n                            \"itemname\": \"Golf clubs\",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \"30.0000\",\n                            \"tax1\": \"10.0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".1700\",\n                            \"currency\": \"USD\"\n                        },\n                        {\n                            \"itemid\": \"4772\",\n                            \"itemname\": \"Ski gear\",\n                            \"quantityforitem\": \"2\",\n                            \"fare\": \"20.0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        },\n                        {\n                            \"itemid\": \"4927\",\n                            \"itemname\": \"free\",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \".0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        }\n                    ]\n                },\n                {\n                    \"name\": \"Sport equipment\",\n                    \"description\": \"sweat and more\",\n                    \"image\": \"https://storage.aerocrs.com/288/system/43.png\",\n                    \"ssrcode\": \"\",\n                    \"icon\": \"fa-golf-ball\",\n                    \"items\": [\n                        {\n                            \"itemid\": \"5170\",\n                            \"itemname\": \"Free\",\n                            \"quantityforitem\": \"10\",\n                            \"fare\": \".0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        },\n                        {\n                            \"itemid\": \"5171\",\n                            \"itemname\": \"Golf clubs\",\n                            \"quantityforitem\": \"10\",\n                            \"fare\": \"5.0000\",\n                            \"tax1\": \"1.0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        },\n                        {\n                            \"itemid\": \"5172\",\n                            \"itemname\": \"Ski gear\",\n                            \"quantityforitem\": \"20\",\n                            \"fare\": \"20.0000\",\n                            \"tax1\": \"1.0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        }\n                    ]\n                },\n                {\n                    \"name\": \"EXCESS BAGGAGE per KG\",\n                    \"description\": \"EXCESS BAGGAGE per KG to sell at airport\",\n                    \"image\": \"https://storage.aerocrs.com/288/system/1.png\",\n                    \"ssrcode\": \"\",\n                    \"icon\": \"fa-suitcase\",\n                    \"items\": [\n                        {\n                            \"itemid\": \"6083\",\n                            \"itemname\": \"2 KG\",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \"6.0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        }\n                    ]\n                },\n                {\n                    \"name\": \"Yuriy test service\",\n                    \"description\": \"yuriy  desc.\",\n                    \"image\": \"https://storage.aerocrs.com/288/system/1.png\",\n                    \"ssrcode\": \"\",\n                    \"icon\": \"fa-suitcase\",\n                    \"items\": [\n                        {\n                            \"itemid\": \"6295\",\n                            \"itemname\": \"test price\",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \"12.0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        },\n                        {\n                            \"itemid\": \"6296\",\n                            \"itemname\": \"test service 2\",\n                            \"quantityforitem\": \"1\",\n                            \"fare\": \"13.0000\",\n                            \"tax1\": \".0000\",\n                            \"tax2\": \".0000\",\n                            \"tax3\": \".0000\",\n                            \"tax4\": \".0000\",\n                            \"vat\": \".0000\",\n                            \"currency\": \"USD\"\n                        }\n                    ]\n                }\n            ]\n        }\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "aerocrs": {
                      "type": "object",
                      "properties": {
                        "success": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "ancillaries": {
                          "type": "object",
                          "properties": {
                            "ancillary": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "name": {
                                    "type": "string",
                                    "example": "/ Pets / #"
                                  },
                                  "description": {
                                    "type": "string",
                                    "example": "Dog / or Cat &#43;$"
                                  },
                                  "image": {
                                    "type": "string",
                                    "example": "https://storage.aerocrs.com/288/system/1.png"
                                  },
                                  "ssrcode": {
                                    "type": "string",
                                    "example": ""
                                  },
                                  "icon": {
                                    "type": "string",
                                    "example": "fa-dog"
                                  },
                                  "items": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "itemid": {
                                          "type": "string",
                                          "example": "4712"
                                        },
                                        "itemname": {
                                          "type": "string",
                                          "example": "Dog $ or /  Cat # "
                                        },
                                        "quantityforitem": {
                                          "type": "string",
                                          "example": "1"
                                        },
                                        "fare": {
                                          "type": "string",
                                          "example": "50.0000"
                                        },
                                        "tax1": {
                                          "type": "string",
                                          "example": ".0000"
                                        },
                                        "tax2": {
                                          "type": "string",
                                          "example": ".0000"
                                        },
                                        "tax3": {
                                          "type": "string",
                                          "example": ".0000"
                                        },
                                        "tax4": {
                                          "type": "string",
                                          "example": ".0000"
                                        },
                                        "vat": {
                                          "type": "string",
                                          "example": ".0000"
                                        },
                                        "currency": {
                                          "type": "string",
                                          "example": "USD"
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "application/xml": {
                "examples": {
                  "XML": {
                    "value": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<aerocrs>\n    <success>true</success>\n    <ancillaries>\n        <ancillary>\n            <name>/ Pets / #</name>\n            <description>Dog / or Cat &amp;#43;$</description>\n            <image>https://storage.aerocrs.com/288/system/1.png</image>\n            <ssrcode/>\n            <icon>fa-dog</icon>\n            <items>\n                <itemid>4712</itemid>\n                <itemname>Dog $ or /  Cat # </itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>50.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n        </ancillary>\n        <ancillary>\n            <name>Sport Equipment</name>\n            <description>sweat and more</description>\n            <image>https://storage.aerocrs.com/288/system/43.png</image>\n            <ssrcode/>\n            <icon>fa-biking</icon>\n            <items>\n                <itemid>4771</itemid>\n                <itemname>Golf clubs</itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>30.0000</fare>\n                <tax1>10.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.1700</vat>\n                <currency>USD</currency>\n            </items>\n            <items>\n                <itemid>4772</itemid>\n                <itemname>Ski gear</itemname>\n                <quantityforitem>2</quantityforitem>\n                <fare>20.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n            <items>\n                <itemid>4927</itemid>\n                <itemname>free</itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n        </ancillary>\n        <ancillary>\n            <name>Sport equipment</name>\n            <description>sweat and more</description>\n            <image>https://storage.aerocrs.com/288/system/43.png</image>\n            <ssrcode/>\n            <icon>fa-golf-ball</icon>\n            <items>\n                <itemid>5170</itemid>\n                <itemname>Free</itemname>\n                <quantityforitem>10</quantityforitem>\n                <fare>.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n            <items>\n                <itemid>5171</itemid>\n                <itemname>Golf clubs</itemname>\n                <quantityforitem>10</quantityforitem>\n                <fare>5.0000</fare>\n                <tax1>1.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n            <items>\n                <itemid>5172</itemid>\n                <itemname>Ski gear</itemname>\n                <quantityforitem>20</quantityforitem>\n                <fare>20.0000</fare>\n                <tax1>1.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n        </ancillary>\n        <ancillary>\n            <name>EXCESS BAGGAGE per KG</name>\n            <description>EXCESS BAGGAGE per KG to sell at airport</description>\n            <image>https://storage.aerocrs.com/288/system/1.png</image>\n            <ssrcode/>\n            <icon>fa-suitcase</icon>\n            <items>\n                <itemid>6083</itemid>\n                <itemname>2 KG</itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>6.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n        </ancillary>\n        <ancillary>\n            <name>Yuriy test service</name>\n            <description>yuriy  desc.</description>\n            <image>https://storage.aerocrs.com/288/system/1.png</image>\n            <ssrcode/>\n            <icon>fa-suitcase</icon>\n            <items>\n                <itemid>6295</itemid>\n                <itemname>test price</itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>12.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n            <items>\n                <itemid>6296</itemid>\n                <itemname>test service 2</itemname>\n                <quantityforitem>1</quantityforitem>\n                <fare>13.0000</fare>\n                <tax1>.0000</tax1>\n                <tax2>.0000</tax2>\n                <tax3>.0000</tax3>\n                <tax4>.0000</tax4>\n                <vat>.0000</vat>\n                <currency>USD</currency>\n            </items>\n        </ancillary>\n    </ancillaries>\n</aerocrs>"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [],
        "x-readme": {
          "code-samples": [
            {
              "language": "xml",
              "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?> \n<aerocrs>\n\t<parms>\n\t\t<flightid>10953299</flightid>\n\t\t<bookingid>36109690</bookingid>\n\t\t<currency>USD</currency>\n\t</parms>\n</aerocrs>"
            }
          ],
          "samples-languages": [
            "xml"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```