# NOTAMs RAW endpoint (get-notams-raw v2)

The following document contains details about RAW NOTAMs active endpoint in version v2.

The output contains NOTAMs (and their interpretations) valid for a moment of query, filtered out to specific dates. The datetime filters (`starts_at` / `ends_at`) takes into consideration notam firm range, without using the timing section for the filtering (`schedules` ). The endpoint is created to prefetch the notams before pulling interpretations for verification purposes.

**Limitations:**

* The endpoint accepts 5 ICAO codes per call.
* The start date cannot be earlier than one day before current UTC datetime.
* ends\_at must be later than starts\_at



**Example param setup in the URL:**

```url
https://api.notamify.com/api/v2/notams/raw?location=EDDM&location=EGLL&starts_at=2025-05-06T00:00:00.000&ends_at=2025-05-06T23:59:00.000
```

## Get active NOTAMs without interpretations

> Returns raw NOTAMs without AI interpretations. Same query parameters and response shape as /notams, but each NOTAM has interpretation set to null. The endpoint purpose is verifying query and raw data before AI interpretation.

```json
{"openapi":"3.1.1","info":{"title":"Notamify API V2","version":"0.0.9"},"servers":[{"url":"https://api.notamify.com/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/notams/raw":{"get":{"summary":"Get active NOTAMs without interpretations","description":"Returns raw NOTAMs without AI interpretations. Same query parameters and response shape as /notams, but each NOTAM has interpretation set to null. The endpoint purpose is verifying query and raw data before AI interpretation.","parameters":[{"description":"Page number to retrieve. Defaults to 1.","required":false,"deprecated":false,"schema":{"type":"integer","title":"Page","description":"Page number to retrieve. Defaults to 1.","default":1},"name":"page","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"Number of NOTAMs per page. Defaults to 30.","required":false,"deprecated":false,"schema":{"type":"integer","maximum":30,"minimum":1,"title":"Per Page","description":"Number of NOTAMs per page. Defaults to 30.","default":30},"name":"per_page","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"List of 4-character ICAO airport codes or 3-character domestic airport codes. Maximum 5 locations. Can be provided as location.","required":false,"deprecated":false,"schema":{"items":{"type":"string","maxLength":4,"minLength":3},"type":"array","maxItems":5,"minItems":1,"title":"Location","description":"List of 4-character ICAO airport codes or 3-character domestic airport codes. Maximum 5 locations. Can be provided as location."},"name":"location","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"List of NOTAM IDs","required":false,"deprecated":false,"schema":{"items":{"type":"string"},"type":"array","title":"Notam Ids","description":"List of NOTAM IDs"},"name":"notam_ids","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"Start date for the time period (YYYY-MM-DDTHH:MM:SSZ)","required":false,"deprecated":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At","description":"Start date for the time period (YYYY-MM-DDTHH:MM:SSZ)"},"name":"starts_at","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"End date for the time period (YYYY-MM-DDTHH:MM:SSZ)","required":false,"deprecated":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At","description":"End date for the time period (YYYY-MM-DDTHH:MM:SSZ)"},"name":"ends_at","in":"query","allowEmptyValue":false,"allowReserved":false}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"properties":{"notams":{"items":{"properties":{"id":{"type":"string","format":"uuid","title":"Id","description":"Unique identifier for the NOTAM."},"notam_number":{"type":"string","title":"Notam Number","description":"NOTAM number or identifier."},"location":{"type":"string","title":"Location","description":"Location where the NOTAM is applicable."},"icao_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icao Code","description":"ICAO code for the airport or facility."},"starts_at":{"type":"string","format":"date-time","title":"Starts At","description":"Start datetime of NOTAM validity."},"ends_at":{"type":"string","format":"date-time","title":"Ends At","description":"End datetime of NOTAM validity."},"issued_at":{"type":"string","format":"date-time","title":"Issued At","description":"Datetime when the NOTAM was issued."},"is_estimated":{"type":"boolean","title":"Is Estimated","description":"Indicates if the NOTAM times are estimated (EST)."},"is_permanent":{"type":"boolean","title":"Is Permanent","description":"Indicates if the NOTAM is permanen (PERM)t."},"message":{"type":"string","title":"Message","description":"Only the message of the NOTAM."},"icao_message":{"type":"string","title":"Icao Message","description":"Only the ICAO formatted message of the NOTAM."},"interpretation":{"anyOf":[{"properties":{"description":{"type":"string","title":"Description","description":"Detailed description of the NOTAM interpretation."},"excerpt":{"type":"string","title":"Excerpt","description":"Brief excerpt summarizing the interpretation."},"category":{"type":"string","title":"Category","description":"Interpretation category."},"subcategory":{"type":"string","title":"Subcategory","description":"Interpretation subcategory."},"map_elements":{"anyOf":[{"items":{"properties":{"element_type":{"type":"string","title":"Element Type","description":"Type of the map element (e.g., line, polygon, point)."},"coordinates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Coordinates","description":"Coordinates of the map element."},"description":{"type":"string","title":"Description","description":"Description of the map element."},"area_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Area Number","description":"Optional area number identifier for the element."},"geojson":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geojson","description":"GeoJSON representation of the map element."}},"type":"object","required":["element_type","coordinates","description"],"title":"NotamMapElementDTO","description":"Data Transfer Object for NOTAM map elements."},"type":"array"},{"type":"null"}],"title":"Map Elements","description":"List of map elements extracted from the interpretation."},"affected_elements":{"items":{"properties":{"type":{"type":"string","title":"Type","description":"Type of the affected element."},"identifier":{"type":"string","title":"Identifier","description":"Identifier of the affected element."},"effect":{"type":"string","title":"Effect","description":"Effect experienced by the element."},"details":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Details","description":"Additional details regarding the effect, if any."}},"type":"object","required":["type","identifier","effect"],"title":"AffectedElementDTO"},"type":"array","title":"Affected Elements","description":"List of affected elements described in the NOTAM."},"schedules":{"items":{"properties":{"source":{"type":"string","title":"Source","description":"Source of the schedule interpretation."},"description":{"type":"string","title":"Description","description":"Description of the schedule interpretation."},"rrule":{"type":"string","title":"Rrule","description":"Recurrence rule for the schedule."},"duration_hrs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Hrs","description":"Duration of each recurrence of the schedule period in hours."},"is_sunrise_sunset":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Sunrise Sunset","description":"Indicates if the schedule is based on sunrise/sunset timings."}},"type":"object","required":["source","description","rrule"],"title":"NotamScheduleInterpretationDTO"},"type":"array","title":"Schedules","description":"List of schedule interpretations for the NOTAM."},"schedule_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Description","description":"Human-readable schedule description."}},"type":"object","required":["description","excerpt","category","subcategory"],"title":"NotamInterpretationDTO"},{"type":"null"}],"description":"Interpretation details of the NOTAM."}},"type":"object","required":["id","notam_number","location","starts_at","ends_at","issued_at","is_estimated","is_permanent","message","icao_message"],"title":"NotamDTO","description":"Data Transfer Object (DTO) for a NOTAM (Notice to Air Missions).\n\nAttributes:\n    notam_number (str): The unique identifier for the NOTAM\n    location (str): The facility designator/location identifier this NOTAM applies to\n    starts_at (datetime): When this NOTAM becomes active\n    ends_at (datetime): When this NOTAM expires\n    message (str): The human-readable traditional format message\n    icao_message (str): The ICAO format message\n    interpretation (Optional[NotamInterpretationDTO]): Optional interpretation of the NOTAM content"},"type":"array","title":"Notams"},"total_count":{"type":"integer","title":"Total Count"},"page":{"type":"integer","title":"Page"},"per_page":{"type":"integer","title":"Per Page"}},"type":"object","required":["notams","total_count","page","per_page"],"title":"NotamListResult"}}}}},"deprecated":false}}}}
```
