openapi: 3.0.1
info:
title: Aeronautic Product Release API
description: FAA Aeronautic chart publication download API
contact:
name: Aeronautic Product Release API (APRA)
url: http://www.faa.gov/got_data
email: edai-aero@faa.gov
license:
name: Creative Commons 0 (CC0)
url: https://creativecommons.org/publicdomain/zero/1.0/legalcode
version: 1.4.0
servers:
- url: https://external-api.faa.gov/apra
tags:
- name: US VFR Wall Planning Chart
- name: Coded Instrument Flight Procedures (CIFP)
- name: Oceanic Route Charts
- name: Daily Digital Obstacle File (DDOF)
- name: NASR 28 Day Subscription
- name: Sectional Charts
- name: Digital Enroute Charts US (DDECUS)
- name: IFR Planning Charts
- name: Gulf of Mexico IFR Enroute Chart
- name: IFR Enroute Charts
- name: US Terminal Procedures Publication (TPP)
- name: VFR Helicopter Route Chart
- name: Terminal Area Charts
- name: Digital Enroute Supplement (DERS)
- name: Grand Canyon VFR Chart
- name: Supplement Chart
paths:
/cifp/chart:
get:
tags:
- Coded Instrument Flight Procedures (CIFP)
summary: "Get CIFP chart download link by edition type of current or next. If\
\ edition is left blank or null, the default edition of current is used."
description: The CIFP release is distributed as a zip file containing charts
and verification software.
operationId: getCIFPRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/cifp/info:
get:
tags:
- Coded Instrument Flight Procedures (CIFP)
summary: "Get CIFP edition date and edition number by edition type of current\
\ or next. If the edition is left blank or null, the default edition of current\
\ is used."
operationId: getCIFPEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ddof/chart:
get:
tags:
- Daily Digital Obstacle File (DDOF)
summary: Get Daily Digital Obstacle File download link.
description: The Daily Digital Obstacle File release is distributed as a zip
file containing the latest obstacle information from the FAA database.
operationId: getDDOFRelease
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ddof/info:
get:
tags:
- Daily Digital Obstacle File (DDOF)
summary: Get Daily Digital Obstacle File edition information.
description: The Daily Digital Obstacle File is released by the FAA on a daily
basis.
operationId: getDDOFEdition
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/dec/chart:
get:
tags:
- Digital Enroute Charts US (DDECUS)
summary: "Get Digital Enroute Chart download link by edition type of current\
\ or next. If edition is left blank or null, the default edition of current\
\ is used."
description: The DEC US release is distributed as a zip file containing charts.
operationId: getDECRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/dec/info:
get:
tags:
- Digital Enroute Charts US (DDECUS)
summary: "Get CIFP edition date and edition number by edition type of current\
\ or next. If the edition is left blank or null, the default edition of current\
\ is used."
operationId: getDECEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ders/chart:
get:
tags:
- Digital Enroute Supplement (DERS)
summary: Get Digital Enroute Supplement download link.
description: The Digital Enroute Supplement release has been deprecated and
is no longer published by the FAA..
operationId: getDERSRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"404":
description: This product has been deprecated and is no longer published
by the FAA.
content: {}
deprecated: true
/ders/info:
get:
tags:
- Digital Enroute Supplement (DERS)
summary: Get Digital Enroute Supplement edition information.
description: The Digital Enroute Supplement release has been deprecated and
is no longer published by the FAA.
operationId: getDERSEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"404":
description: This product has been deprecated and is no longer published
by the FAA.
content: {}
deprecated: true
/dtpp/chart:
get:
tags:
- US Terminal Procedures Publication (TPP)
summary: Get Terminal Procedure Publication chart download information by requesting
an edition with geographic area of United States or a valid US State Name.
description: 'The complete United States Terminal Procedure Publication (TPP)
release is distributed as a set of zip files containing charts and verification
software. Requests for charts by state returns a list of download URLs which
can be quite extensive. All 50 US states are valid for requesting chart publication
download URLs. The special ''changeset'' edition operates against the current
release and returns the charts that were changed since the previous release. '
operationId: getTPPRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
- changeset
default: current
- name: geoname
in: query
description: "Requested geographic region of Terminal Procedures Publication\
\ chart set. Specify either US or a valid full state name such as Alaska.\
\ If omitted, the default US complete set is returned."
schema:
type: string
default: US
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/dtpp/info:
get:
tags:
- US Terminal Procedures Publication (TPP)
summary: Get Terminal Procedure Publication chart edition information by requesting
an edition with geographic area of United States or one of the 50 US states
description: The US Terminal Procedure Publication is released on a 28 day airspace
cycle. Edition information is identical regardless of the geographic area
or format of the desired charts.
operationId: getTPPEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ information is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: geoname
in: query
description: "Requested geographic region of Terminal Procedures Publication\
\ chart set. Specify US or a valid full US state name such as Alaska. If\
\ omitted, edition information for the complete US set is returned."
schema:
type: string
default: US
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/enroute/chart:
get:
tags:
- IFR Enroute Charts
summary: "Get IFR Enroute Charts download link by edition, format, geoname,\
\ and seriesType"
description: "TIFF formatted files are geo-referenced while PDF format is not\
\ geo-referenced. Geoname is either US, Alaska, Pacific, or Caribbean, depending\
\ on the desired chart. A list of available charts by format, geoname, and\
\ series type can be found on the FAA public web site at FAA Home > Air Traffic\
\ > Flight Information > Aeronautical Information Services > Digital Products\
\ > IFR Charts and DERS > Low, High Areas tab. The valid values for seriesType\
\ are Low, High, or Area."
operationId: getIFREnrouteRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: format
in: query
description: "Format of the requested chart. TIFF is georeferenced and PDF\
\ is not georeferencedIf omitted, the default format of PDF is returned."
schema:
type: string
enum:
- tiff
- pdf
default: pdf
- name: geoname
in: query
description: Geographic region for requested chart
required: true
schema:
type: string
enum:
- US
- Alaska
- Pacific
- Caribbean
- name: seriesType
in: query
description: The series type
required: true
schema:
type: string
enum:
- low
- high
- area
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/enroute/gom/chart:
get:
tags:
- Gulf of Mexico IFR Enroute Chart
summary: "Get Gulf of Mexico IFR enroute chart edition date, edition number,\
\ and product download URL"
description: The Gulf of Mexico IFR enroute chart is distributed as a zip file
that contains multiple PDF charts.
operationId: getGOMRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: format
in: query
description: "Format of the requested chart. TIFF is georeferenced and PDF\
\ is not georeferenced. If omitted, the default format of PDF is returned."
schema:
type: string
enum:
- tiff
- pdf
default: pdf
- name: geoname
in: query
description: "Requested Gulf of Mexico geographic area. If omitted, both west\
\ and central links are returned."
schema:
type: string
enum:
- west
- central
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/enroute/gom/info:
get:
tags:
- Gulf of Mexico IFR Enroute Chart
summary: Get Gulf of Mexico IFR enroute chart edition date and edition number
description: "If a geographic area is not supplied, both central and west product\
\ edition information is returned."
operationId: getGOMEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, current edition is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: geoname
in: query
description: "Requested Gulf of Mexico geographic area. If omitted, both west\
\ and central are returned."
schema:
type: string
enum:
- west
- central
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/enroute/info:
get:
tags:
- IFR Enroute Charts
summary: Get IFR Enroute Charts edition date and edition number by edition type
of current or next
operationId: getIFREnrouteEdition
parameters:
- name: edition
in: query
description: Requested product edition
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ifr/oceanic/chart:
get:
tags:
- Oceanic Route Charts
summary: "Get Oceanic Route Chart download link by edition, format, and geoname"
description: "TIFF formatted files are geo-referenced while PDF format is not\
\ geo-referenced. Geoname is a geographic area for which the chart is requested.\
\ Valid geographic names are Pacific (PORC), North Atlantic (NARC), and Wester\
\ Atlantic (WATRS) "
operationId: getOceanicRouteChart
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: format
in: query
description: "Format of the requested chart. TIFF is georeferenced and PDF\
\ is not georeferenced. If omitted, the default format of PDF is returned."
schema:
type: string
enum:
- tiff
- pdf
default: pdf
- name: geoname
in: query
description: A geographic area for which the chart is requested
required: true
schema:
type: string
enum:
- NARC
- PORC
- WATRS
default: PORC
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ifr/oceanic/info:
get:
tags:
- Oceanic Route Charts
summary: Get Oceanic Route Chart edition information by edition type
description: All oceanic charts are released on a regular 56 day cycle. The
format and geographic name are not necessary to obtain edition information.
operationId: getOceanicRouteEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ information is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ifr/planning/chart:
get:
tags:
- IFR Planning Charts
summary: Get IFR planning download link by edition and format
description: TIFF formatted files are geo-referenced while PDF format is not
geo-referenced. The specific chart returned by this operation is the IFR
PLANNING chart found on the FAA public web site at FAA Home > Air Traffic
> Flight Information > Aeronautical Information Services > Digital Products
> IFR Charts and DERS > Planning tab
operationId: getIfrPlanningChart
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: format
in: query
description: "Format of the requested chart. TIFF is georeferenced and PDF\
\ is not georeferenced. If omitted, the default PDF format is returned."
schema:
type: string
enum:
- tiff
- pdf
default: pdf
- name: geoname
in: query
description: "Geographic area to query. North Atlantic (NA), Pacific Ocean\
\ (PO), Western Atlantic (WAT), or United States (US)"
schema:
type: string
enum:
- NA
- PO
- WAT
- US
default: US
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/ifr/planning/info:
get:
tags:
- IFR Planning Charts
summary: Get Planning Chart edition date and edition number by edition type
operationId: getIfrPlanningInfo
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ information is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/nfdc/nasr/chart:
get:
tags:
- NASR 28 Day Subscription
summary: Get the National Flight Data Center NASR 28 day subscription file
operationId: getNASRSubscription
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/nfdc/nasr/info:
get:
tags:
- NASR 28 Day Subscription
summary: Get the National Flight Data Center NASR 28 day subscription file edition
information
operationId: getNASREdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/supplement/chart:
get:
tags:
- 'Supplement Chart '
summary: Get Supplement chart download information by requesting an edition
with a valid US volume.
description: The Supplement chart is distributed in two formats - zip and pdf.
The US complete set is returned as a ZIP file while all other volumes consist
of individual PDF files.Requests for charts by volume other than US complete
set returns a list of download URLs which can be quite extensive.
operationId: getSupplementRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: volume
in: query
description: "Requested volume of Supplement chart set. If omitted, the complete\
\ US set is returned."
schema:
type: string
enum:
- NORTHWEST
- SOUTHWEST
- NORTH CENTRAL
- SOUTH CENTRAL
- EAST CENTRAL
- SOUTHEAST
- NORTHEAST
- PACIFIC
- ALASKA
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/supplement/info:
get:
tags:
- 'Supplement Chart '
summary: Get Supplement chart edition information by requesting an edition and
volume.
operationId: getSupplementEdition
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
- name: volume
in: query
description: "Requested volume of Supplement chart set. If omitted, the edition\
\ information for the complete US set is returned."
schema:
type: string
enum:
- NORTHWEST
- SOUTHWEST
- NORTH CENTRAL
- SOUTH CENTRAL
- EAST CENTRAL
- SOUTHEAST
- NORTHEAST
- PACIFIC
- ALASKA
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/vfr/grandcanyon/chart:
get:
tags:
- Grand Canyon VFR Chart
summary: Get VFR Grand Canyon chart edition information and download link
operationId: getGrandCanyonRelease
parameters:
- name: edition
in: query
description: "Requested product edition. If omitted, the default current edition\
\ is returned."
schema:
type: string
enum:
- current
- next
default: current
responses:
"200":
description: OK
content: {}
"400":
description: Illegal arguments provided to service. One or more of the service
parameter values is invalid
content: {}
"404":
description: Requested edition has not been released for download or could
not be found on the FAA aeronav web site.
content: {}
"500":
description: Internal service error occurred which prevented a valid response
from being returned.
content: {}
/vfr/grandcanyon/info:
get:
tags:
- Grand Canyon VFR Chart
summary: Get VFR edition date and edition number by edition type of current
or next
operationId: getGrandCanyonEdition
parameters:
- name: edition
# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/us-dot/refs/heads/main/openapi/us-dot-faa-aeronautic-product-release-api-openapi.yml