Quick start

Welcome to the Notamify API Quick Start Guide. In this document, you’ll learn how to make your first API call, understand essential parameters, and interpret the responses. By the end, you should have

1. Prerequisites

• Notamify Pro Subscription: API access is included in the Notamify Pro plan. Click here to start your 7 days free, and 20 API credits.

• API Credits: Ensure you have a sufficient API credit package (e.g., Intro, Growth, Scale, or Enterprise).

• Tools: Any HTTP client or integration library (e.g., curl, Postman, or a programming language with REST support).

2. Getting Your API Key

1. Sign up or Log in to your Notamify account.

2. Navigate to API Manager.

3. Generate a new API key or retrieve your existing key.

Pro Tip: Store your API key securely and never expose it in public repositories or client-side code.

3. Making Your First Request

Below is a minimal curl example to fetch NOTAM data from one or more airports using the /api/get-notams endpoint.

curl --request GET \
  --url "https://api.notamify.com/api/v2/notams?locations=EPWA" \
  --header "Bearer YOUR_API_KEY"

Parameters

• icao: Pass one or more ICAO codes (up to five). Example: ?locations=KJFK

• date_range (optional): Filter NOTAMs by start and end date. Example: ?start_date=2025-01-15&end_date=2025-01-20

4. Understanding the Response

A successful response returns a JSON object with key elements:

{
    "notams": [
        {
            "ends_at": "2222-02-02T02:02:00Z",
            "icao_code": "EDDF",
            "icao_message": "U0038/11 NOTAMN\nQ) EDGG/QFAXX/IV/NBO/A /000/999/5002N00834E005\nA) EDDF B) 1105240716 C) PERM\nE) AD EDDF\n\nGEMIL FLIP VAD\n   EDDF 1 AND EDDF - PROCEDURE\n   PAGES EDDF 1 AND EDDF 2 ARE SUSPENDED.\n   FOR NEW PROCEDURE SEE AIP GERMANY VOLUME VFR EDDF.",
            "interpretation": {
                "category": "ADMINISTRATIVE",
                "description": "The procedures for GEMIL FLIP VAD for Frankfurt (EDDF) have been suspended. For updated procedures, refer to the AIP Germany Volume VFR EDDF.",
                "excerpt": "GEMIL FLIP VAD procedures at EDDF suspended; refer to AIP Germany for new procedures.",
                "subcategory": "OTHER"
            },
            "is_estimated": false,
            "is_permanent": true,
            "issued_at": "2011-06-06T15:47:00Z",
            "location": "EDDF",
            "message": "",
            "notam_number": "U0038/11",
            "starts_at": "2011-05-24T07:16:00Z"
        },
}

• raw_text: The original NOTAM text.

• interpretation: AI-generated summary of the NOTAM.

• categories: One or more standardized categories (among 42 possible).

Note: Interpretations may be truncated if the original text is extremely long, but essential details are preserved.

5. Next Steps

• Explore the Authentication guide to properly secure your API requests.
• Review the Code samples document to start your API integrations.