---
updatedAt: 2026-08-21T05:01:21.000Z
agentTools:
  projectIndex: https://developer.avinodegroup.com/llms.txt
---

# Search airports

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Paynode API",
    "version": "2026-11-12T06:11:40.521311568Z"
  },
  "externalDocs": {
    "description": "Avinode Group Devportal",
    "url": "https://developer.avinodegroup.com"
  },
  "servers": [
    {
      "url": "https://sandbox.avinode.com/payapi",
      "description": "Paynode (development)"
    },
    {
      "url": "https://sandbox.avinode.com/api",
      "description": "Avinode (development)"
    }
  ],
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "Airports",
      "description": ""
    }
  ],
  "paths": {
    "/airports/search": {
      "get": {
        "tags": [
          "Airports"
        ],
        "summary": "Search airports",
        "operationId": "searchAirports",
        "parameters": [
          {
            "name": "filter",
            "in": "query",
            "description": "The airport criteria",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filterMatchType",
            "in": "query",
            "description": "How to match the given criteria.",
            "schema": {
              "type": "string",
              "default": "contains",
              "enum": [
                "contains",
                "starts_with"
              ]
            }
          },
          {
            "name": "latitude",
            "in": "query",
            "description": "The latitude of a search for nearby airports",
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "longitude",
            "in": "query",
            "description": "The longitude of a search for nearby airports",
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "maxDistance",
            "in": "query",
            "description": "The maximum distance (in NM, defaults to 500) of a search for nearby airports",
            "schema": {
              "type": "number",
              "format": "double",
              "default": 500
            }
          },
          {
            "name": "heli",
            "in": "query",
            "description": "Include heliports (boolean)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "military",
            "in": "query",
            "description": "Include military (boolean)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sanctioned",
            "in": "query",
            "description": "Include sanctioned (boolean)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nonstandard",
            "in": "query",
            "description": "Include non standard (not classified as civilian or military) (boolean)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "countries",
            "in": "query",
            "description": "Limit results to airports in one of the given countries. Send 2 character ISO country code, comma delimited for multiple.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "minRunwayLength",
            "in": "query",
            "description": "Min. Runway Length - The minimum runway length of the airport has to be equal or greater than this value (in feet).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page[number]",
            "in": "query",
            "description": "Pagination - page number",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page[size]",
            "in": "query",
            "description": "Pagination - page size",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "query",
            "description": "1-N airport ids (max 200 items)",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "fields[airports]",
            "in": "query",
            "description": "Sparse fields",
            "allowEmptyValue": true,
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "bestcode",
                  "citygroups",
                  "classification",
                  "deeplinks",
                  "displayname",
                  "position",
                  "runwaylength",
                  "timezone"
                ]
              }
            }
          },
          {
            "name": "X-Avinode-SentTimestamp",
            "in": "header",
            "description": "ISO8601 Timestamp",
            "schema": {}
          },
          {
            "name": "X-Avinode-ApiToken",
            "in": "header",
            "description": "API Token",
            "required": false,
            "schema": {}
          },
          {
            "name": "X-Avinode-Product",
            "in": "header",
            "description": "Calling product / software (ex: AcmeApp-v10.2)",
            "schema": {}
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceCollectionRestServerResponseAirportOutputJSON"
                }
              }
            }
          }
        },
        "security": [
          {
            "Bearer": []
          }
        ],
        "x-avi-products": {
          "Avinode": "true",
          "SchedAero": "true",
          "Paynode": "true"
        }
      },
      "servers": [
        {
          "url": "https://sandbox.avinode.com/api",
          "description": "Avinode (development)"
        }
      ]
    }
  },
  "components": {
    "schemas": {
      "ActionLinkJSON": {
        "type": "object",
        "description": "A link describing an action that can be performed on the parent object.",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of action"
          },
          "description": {
            "type": "string",
            "description": "A description of what this action is intended to do"
          },
          "httpMethod": {
            "type": "string",
            "description": "The HTTP method expected by the resource at the target URI"
          },
          "href": {
            "type": "string",
            "description": "The URI for invoking the action"
          }
        }
      },
      "AirportGroupJSON": {
        "type": "object",
        "description": "A grouping of airports",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this resource"
          },
          "href": {
            "type": "string",
            "description": "A URI at which this resource may be read"
          },
          "type": {
            "type": "string",
            "description": "The type of resource"
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/ResourceLinkJSON"
              }
            },
            "description": "Associated links related to this resource"
          },
          "actions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ActionLinkJSON"
            },
            "description": "Associated actions related to this resource"
          },
          "displayName": {
            "type": "string",
            "description": "Display name"
          },
          "description": {
            "type": "string",
            "description": "Description"
          }
        }
      },
      "AirportOutputJSON": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this resource"
          },
          "href": {
            "type": "string",
            "description": "A URI at which this resource may be read"
          },
          "type": {
            "type": "string",
            "description": "The type of resource"
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/ResourceLinkJSON"
              }
            },
            "description": "Associated links related to this resource"
          },
          "actions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ActionLinkJSON"
            },
            "description": "Associated actions related to this resource"
          },
          "name": {
            "type": "string",
            "description": "Airport name"
          },
          "displayName": {
            "type": "string",
            "description": "A describing text about this airport. Contains airport codes, country, province, city"
          },
          "displayCodes": {
            "type": "string",
            "description": "A formatted text for the airport codes"
          },
          "bestCodeForUser": {
            "type": "string",
            "description": "The best code for the current user"
          },
          "city": {
            "type": "string",
            "description": "City"
          },
          "country": {
            "$ref": "#/components/schemas/CountryReferenceJSON",
            "description": "Country"
          },
          "icao": {
            "type": "string",
            "description": "ICAO code"
          },
          "unofficialICAO": {
            "type": "string",
            "description": "Any unofficial ICAO code"
          },
          "iata": {
            "type": "string",
            "description": "IATA code"
          },
          "faa": {
            "type": "string",
            "description": "FAA code"
          },
          "position": {
            "$ref": "#/components/schemas/PositionOutputJSON",
            "description": "The coordinates of the airport"
          },
          "province": {
            "$ref": "#/components/schemas/ProvinceReferenceJSON",
            "description": "Province"
          },
          "timeZoneId": {
            "type": "string",
            "description": "IANA time-zone id"
          },
          "airportType": {
            "$ref": "#/components/schemas/EnumOutputJSON",
            "description": "The type of airport"
          },
          "landingFacility": {
            "$ref": "#/components/schemas/EnumOutputJSON",
            "description": "The landing facilities at the airport"
          },
          "groups": {
            "type": "array",
            "description": "Any groupings this airport is a member of.",
            "items": {
              "$ref": "#/components/schemas/AirportGroupJSON"
            }
          },
          "runwayLength": {
            "type": "integer",
            "format": "int32",
            "description": "The length of the runway"
          }
        }
      },
      "CountryReferenceJSON": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The 2 character country code"
          },
          "name": {
            "type": "string",
            "description": "The name of the country"
          }
        },
        "required": [
          "code",
          "name"
        ]
      },
      "EnumOutputJSON": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this."
          },
          "code": {
            "type": "string",
            "description": "Any standard code for this thing."
          },
          "display": {
            "type": "string",
            "description": "A string for displaying this value."
          }
        },
        "required": [
          "display"
        ]
      },
      "MessageJSON": {
        "type": "object",
        "description": "A single message, could be either an error, warning or a info message.",
        "externalDocs": {
          "url": "https://jsonapi.org/format/#error-objects"
        },
        "properties": {
          "title": {
            "type": "string",
            "description": "a short, human-readable summary of the message"
          },
          "code": {
            "type": "string",
            "description": "an application-specific code, expressed as a string value"
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "deprecated": true,
            "description": "The HTTP status code applicable to this message, expressed as a string value"
          },
          "detail": {
            "type": "string",
            "description": "a human-readable explanation specific to this occurrence of the message"
          },
          "technicalDetail": {
            "type": "string",
            "description": "a human-readable technical explanation intended for technical staff (not end-users)"
          },
          "path": {
            "type": "string",
            "description": "if this message related to a property in the input, the path to the input property in the message"
          }
        },
        "required": [
          "code",
          "title"
        ]
      },
      "MetadataJSON": {
        "type": "object",
        "properties": {
          "errors": {
            "type": "array",
            "description": "Error messages for this response.",
            "items": {
              "$ref": "#/components/schemas/MessageJSON"
            }
          },
          "warnings": {
            "type": "array",
            "description": "Warning messages for this response.",
            "items": {
              "$ref": "#/components/schemas/MessageJSON"
            }
          },
          "infos": {
            "type": "array",
            "description": "Information messages for this response.",
            "items": {
              "$ref": "#/components/schemas/MessageJSON"
            }
          },
          "pagination": {
            "$ref": "#/components/schemas/PaginationJSON",
            "description": "Associated links related to this response"
          },
          "duplicatePOST": {
            "type": "boolean",
            "description": "Will be 'true' if Avinode detected a duplicate POST and replayed the original response"
          }
        }
      },
      "PaginationJSON": {
        "type": "object",
        "properties": {
          "totalCount": {
            "type": "integer",
            "format": "int64",
            "description": "The total number of results in the listing, or matching a search"
          },
          "pageNumber": {
            "type": "integer",
            "format": "int32",
            "description": "The page number"
          },
          "batchSize": {
            "type": "integer",
            "format": "int32",
            "description": "The number of results requested per page."
          }
        }
      },
      "PositionOutputJSON": {
        "type": "object",
        "description": "GPS position coordinates",
        "properties": {
          "longitude": {
            "type": "number",
            "format": "double",
            "description": "The longitude"
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "description": "The latitude"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ]
      },
      "ProvinceReferenceJSON": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The province code"
          },
          "name": {
            "type": "string",
            "description": "The name of the province"
          }
        },
        "required": [
          "code",
          "name"
        ]
      },
      "ResourceCollectionRestServerResponseAirportOutputJSON": {
        "type": "object",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/MetadataJSON",
            "description": "Metadata associated with the response (errors, warnings, etc.)"
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "description": "Associated links related to this response"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AirportOutputJSON"
            }
          }
        },
        "required": [
          "meta"
        ]
      },
      "ResourceLinkJSON": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this resource"
          },
          "href": {
            "type": "string",
            "description": "A URI at which this resource may be read"
          },
          "type": {
            "type": "string",
            "description": "The type of resource"
          },
          "links": {
            "description": "Associated links related to this resource"
          },
          "actions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/ActionLinkJSON"
            },
            "description": "Associated actions related to this resource"
          },
          "displayName": {
            "type": "string",
            "description": "If this link is intended to be visually display, a display name to show."
          }
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    }
  }
}
```