---
title: "Get the canonical ident of a flight"
method: GET
path: "/flights/{ident}/canonical"
tags: ["flights"]
---

# Get the canonical ident of a flight

`GET /flights/{ident}/canonical`

## Request

- Base URL: `https://aeroapi.flightaware.com/aeroapi`
- URL: `https://aeroapi.flightaware.com/aeroapi/flights/{ident}/canonical`
- Auth: API key in header `x-apikey`
- TypeScript: <https://skmtc.dev/flightaware/apis/aeroapi/docs/flights/:ident/canonical/get.ts> (a function with typed inputs; its response is checked against the schema)

When the ident parameter is a code that could map to multiple other codes,
this endpoint returns an array of information about all the possible codes.
An optional ident type and country code can be provided to refine ambiguous
idents to a single result. The ident type should either be designator or
registration to describe the ident being passed in. The country code should
represent a country the operator of the flight operates within.

## Path parameters

- `ident` string, required

## Query parameters

- `ident_type` 'designator' | 'registration'
- `country_code` string

## Response `200`

OK

- object
  - `idents` object[], required
    - `ident` string, required: Canonical ident
    - `ident_type` 'designator' | 'registration', required: Type of ident given in id

## Other responses

- `400`: Incorrect parameter(s). ident, ident_type, or country_code may be invalid.

---

[API](https://skmtc.dev/flightaware/apis/aeroapi.md) - [All operations](https://skmtc.dev/flightaware/apis/aeroapi/llms.txt) - [OpenAPI document](https://skmtc.dev/flightaware/apis/aeroapi/revisions/3023e7a0c54c?raw)