--- updatedAt: 2026-08-20T04:59:43.000Z agentTools: projectIndex: https://developer.avinodegroup.com/llms.txt --- # Search for aircraft by tail number. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Avinode APIs", "version": "2026-10-12T07:48:16.711911277Z" }, "externalDocs": { "description": "Avinode Group Devportal", "url": "https://developer.avinodegroup.com" }, "servers": [ { "url": "https://sandbox.avinode.com/api", "description": "Avinode (development)" }, { "url": "https://schedaero.avinode.com/api" } ], "security": [ { "Bearer": [] } ], "tags": [ { "name": "Aircraft", "description": "" } ], "paths": { "/aircraft/search": { "get": { "tags": [ "Aircraft" ], "summary": "Search for aircraft by tail number.", "operationId": "searchAircraft", "parameters": [ { "name": "tail", "in": "query", "description": "1-N tail numbers", "required": true, "explode": true, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "fields[companies]", "in": "query", "description": "Company sparse fields", "allowEmptyValue": true, "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "contactinfo", "logo", "office", "offices", "productgroups", "wfscustomer" ] } } }, { "name": "fields[aircraft]", "in": "query", "description": "Aircraft sparse fields", "allowEmptyValue": true, "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "amenities", "categorydetails", "homebase", "insurance", "liftaoc", "perfdetails", "safety", "sellercontactinfo", "sellerstats", "taildetails", "tailphotos", "typedetails", "typephotos" ] } } }, { "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/ResourceCollectionRestServerResponseAircraftOutputJSON" } } } } }, "security": [ { "Bearer": [] } ], "x-avi-products": { "Avinode": "true", "SchedAero": "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" } } }, "AddressOutputJSON": { "type": "object", "properties": { "street": { "type": "string", "description": "Street address" }, "postBox": { "type": "string", "description": "Post box" }, "postCode": { "type": "string", "description": "Post code / Zip Code" }, "city": { "type": "string", "description": "City" }, "country": { "$ref": "#/components/schemas/CountryReferenceJSON", "description": "Country" }, "province": { "type": "string", "description": "Province / State" } } }, "AircraftCategoryDetailsJSON": { "type": "object", "description": "Details about an aircraft category", "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" } } }, "AircraftCertificateOutputJSON": { "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" }, "certificateNumber": { "type": "string", "description": "The AOC number" }, "issuingCountry": { "$ref": "#/components/schemas/CountryReferenceJSON", "description": "The country that issued the AOC" } }, "required": [ "certificateNumber" ] }, "AircraftInsuranceDetailsJSON": { "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" }, "monetaryAmount": { "$ref": "#/components/schemas/PriceOutputJSON", "description": "The insurance amount" } } }, "AircraftOutputJSON": { "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" }, "sellerCompany": { "$ref": "#/components/schemas/CompanyOutputJSON", "description": "The seller company for this aircraft." }, "operator": { "$ref": "#/components/schemas/CompanyOutputJSON", "description": "The company operating this aircraft. Only populated if different than 'sellerCompany'." }, "lift": { "$ref": "#/components/schemas/LiftOutputJSON", "description": "The lift." } } }, "AircraftPhotoCopyJSON": { "type": "object", "description": "A variant of an aircraft photo", "properties": { "size": { "type": "string", "description": "Photo size", "enum": [ "THUMBNAIL,SMALL,MEDIUM,LARGE" ] }, "url": { "type": "string", "description": "Photo URL" }, "anonymized": { "type": "boolean", "description": "Is this an anonymized version of the photo" } }, "required": [ "anonymized", "size", "url" ] }, "AircraftPhotoJSON": { "type": "object", "properties": { "type": { "type": "string", "description": "The type of photo", "enum": [ "EXTERIOR,INTERIOR,FLOORPLAN,OVERVIEW,OTHER" ] }, "copies": { "type": "array", "description": "Variants of this photo", "items": { "$ref": "#/components/schemas/AircraftPhotoCopyJSON" } } }, "required": [ "copies", "type" ] }, "AircraftTailDetailsJSON": { "type": "object", "description": "Details about an aircraft tail", "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" }, "yearOfMake": { "type": "integer", "format": "int32", "description": "Year of make" }, "interiorRefurbished": { "type": "string", "format": "date-time", "description": "Interior refurbishment date" }, "exteriorRefurbished": { "type": "string", "format": "date-time", "description": "Exterior refurbishment date" }, "amenities": { "type": "array", "description": "Any amenities that the aircraft has", "items": { "type": "string" } }, "insurance": { "$ref": "#/components/schemas/AircraftInsuranceDetailsJSON", "description": "Insurance details" }, "termsAndConditions": { "type": "string", "format": "uri", "description": "Any terms and conditions for this aircraft." } } }, "AircraftTypeDetailsJSON": { "type": "object", "description": "Details about an aircraft type", "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" }, "icaoCode": { "type": "string", "description": "The ICAO code, if any, for this type" } } }, "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" } } }, "CompanyOutputJSON": { "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" }, "displayName": { "type": "string", "description": "A display name for this company" }, "demo": { "type": "boolean", "description": "Is this a demo company?" }, "contactInfo": { "$ref": "#/components/schemas/OfficeContactInfoOutputJSON", "description": "Contact info for this company" }, "companyLogoUrl": { "type": "string", "description": "Company logo for this company" }, "icaoDesignator": { "type": "string", "description": "ICAO Operator Designator for this company" }, "offices": { "type": "array", "description": "Office information for this company.", "items": { "$ref": "#/components/schemas/OfficeOutputJSON" } } }, "required": [ "displayName" ] }, "ContactInfoOutputJSON": { "type": "object", "properties": { "name": { "type": "string", "description": "Name" }, "emails": { "type": "array", "description": "Email addresses", "items": { "type": "string" } }, "phone": { "type": "string", "description": "Phone number" }, "mobilePhone": { "type": "string", "description": "Mobile phone number" }, "url": { "type": "string", "description": "Website URL" } } }, "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" ] }, "LiftOutputJSON": { "type": "object", "description": "Lift data", "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" }, "aircraftCategory": { "type": "string", "description": "The category of the lift" }, "aircraftType": { "type": "string", "description": "The type of lift" }, "aircraftSuperType": { "type": "string", "description": "The super type of lift" }, "aircraftTypeDetails": { "$ref": "#/components/schemas/AircraftTypeDetailsJSON", "description": "Details about the aircraft type" }, "aircraftCategoryDetails": { "$ref": "#/components/schemas/AircraftCategoryDetailsJSON", "description": "Details about the aircraft category" }, "aircraftTail": { "type": "string", "description": "The aircraft tail number" }, "aircraftTailDetails": { "$ref": "#/components/schemas/AircraftTailDetailsJSON", "description": "Details about the aircraft tail" }, "liftPerformance": { "$ref": "#/components/schemas/LiftPerformanceDetailsJSON", "description": "Performance data for this lift" }, "aircraftCertificate": { "$ref": "#/components/schemas/AircraftCertificateOutputJSON", "description": "The certificate the lift is registered on" }, "maxPax": { "type": "integer", "format": "int32", "description": "The maximum number of passengers on this lift" }, "sellerStatistics": { "$ref": "#/components/schemas/SellerStatisticsOutputJSON", "description": "Seller statistics" }, "tailPhotos": { "type": "array", "description": "Aircraft Tail Photos", "items": { "$ref": "#/components/schemas/AircraftPhotoJSON" } }, "typePhotos": { "type": "array", "description": "Aircraft type Photos", "items": { "$ref": "#/components/schemas/AircraftPhotoJSON" } }, "homebase": { "$ref": "#/components/schemas/AirportOutputJSON", "description": "Homebase airport" }, "safetyRatings": { "type": "array", "description": "Any safety ratings tied to this aircraft", "items": { "$ref": "#/components/schemas/SafetyRatingOutputJSON" } } } }, "LiftPerformanceDetailsJSON": { "type": "object", "description": "Details for the performance of a piece of lift (flight times)", "properties": { "maxRangeNM": { "type": "string", "description": "The maximum range of the lift in nautical miles" }, "cruiseSpeedKnots": { "type": "string", "description": "The cruise speed of the lift in knots" } } }, "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" } } }, "OfficeContactInfoOutputJSON": { "type": "object", "properties": { "emails": { "type": "array", "description": "Email addresses", "items": { "type": "string" } }, "phone": { "type": "string", "description": "Phone number" }, "mobilePhone": { "type": "string", "description": "Mobile phone number" }, "url": { "type": "string", "description": "Website URL" }, "office": { "type": "string", "description": "Office name" }, "address": { "type": "string", "description": "Office formatted address" }, "detailedAddress": { "$ref": "#/components/schemas/AddressOutputJSON", "description": "Office detailed address" } } }, "OfficeOutputJSON": { "type": "object", "properties": { "headOffice": { "type": "boolean", "description": "Is this the head office ?" }, "displayName": { "type": "string", "description": "A display name for this office" }, "contactInfo": { "$ref": "#/components/schemas/ContactInfoOutputJSON", "description": "Contact information for this office" }, "address": { "$ref": "#/components/schemas/AddressOutputJSON", "description": "Address for this office" } }, "required": [ "displayName", "headOffice" ] }, "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" ] }, "PriceOutputJSON": { "type": "object", "properties": { "currency": { "type": "string", "description": "The currency" }, "price": { "type": "number", "description": "The price in the currency." }, "conversionCurrency": { "type": "string", "description": "If another currency was preferred rather than the original currency" }, "convertedPrice": { "type": "number", "description": "The price converted to the conversion currency." }, "priceAsString": { "type": "string" } }, "required": [ "currency", "price" ] }, "ProvinceReferenceJSON": { "type": "object", "properties": { "code": { "type": "string", "description": "The province code" }, "name": { "type": "string", "description": "The name of the province" } }, "required": [ "code", "name" ] }, "ResourceCollectionRestServerResponseAircraftOutputJSON": { "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/AircraftOutputJSON" } } }, "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." } } }, "SafetyRatingOutputJSON": { "type": "object", "properties": { "standard": { "type": "string", "description": "What safety standard this rating is from.", "enum": [ "ARGUS,WYVERN" ] }, "levelCode": { "type": "string", "description": "What level is the safety rating at in the given standard. This is a fixed code for the given level intended for sofware consumption." }, "levelDisplayName": { "type": "string", "description": "A human readable display name for the level." }, "latestSyncedOn": { "type": "string", "description": "A timestamp stating when this rating was last synced from the standards organization." } }, "required": [ "levelCode", "levelDisplayName", "standard" ] }, "SellerStatisticsOutputJSON": { "type": "object", "properties": { "quoteCount": { "type": "integer", "format": "int32", "description": "The number of seller quotes considered in these statistics" }, "underPricedQuoteCount": { "type": "integer", "format": "int32", "description": "The count of seller quotes where the price was LESS THAN marketplace quote." }, "underPricedQuoteAveragePercent": { "type": "number", "description": "The absolute, average percent difference that seller quote prices are LESS THAN the marketplace quote." }, "overPricedQuoteCount": { "type": "integer", "format": "int32", "description": "The count of seller quotes where the price was GREATER THAN marketplace quote." }, "overPricedQuoteAveragePercent": { "type": "number", "description": "The absolute, average percent difference that seller quote prices are GREATER THAN the marketplace quote." }, "medianResponseTimeMinutes": { "type": "integer", "format": "int32", "description": "The median response time in minutes for the seller to respond to a request" }, "responseRatePercent": { "type": "number", "description": "The percentage of times that the seller responds to a request" }, "priceAccuracyPercent": { "type": "integer", "format": "int32", "description": "Percent of quotes with a price increase below a threshold (defined in Avinode)" } } } }, "securitySchemes": { "Bearer": { "type": "apiKey", "name": "Authorization", "in": "header" } } } } ```