> For the complete documentation index, see [llms.txt](https://skymerse.gitbook.io/notamify-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://skymerse.gitbook.io/notamify-api/simple-briefing-endpoint.md).

# Simple Briefing endpoint

{% hint style="warning" %}
**Early Preview** This endpoint is currently in Early Preview. Pricing, input/output structure, and performance are subject to change. The endpoint may be discontinued at any time. We welcome your feedback at <hello@notamify.com>.
{% endhint %}

## Generate simple airport briefing

> Returns an immediate, airport-focused NOTAM briefing: a readable summary of active notices for the requested airports, plus the NOTAM identifiers referenced.

```json
{"openapi":"3.1.1","info":{"title":"Notamify API V2","version":"0.0.14"},"servers":[{"url":"https://api.notamify.com/api/v2"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"SimpleAirportBriefingResponse":{"properties":{"location":{"type":"string","title":"Location","description":"ICAO airport code covered by the briefing."},"summary":{"type":"string","title":"Summary","description":"Generated airport briefing summary text."},"notam_ids":{"items":{"type":"string"},"type":"array","title":"Notam Ids","description":"NOTAM numbers used to generate the briefing, in briefing order."}},"type":"object","required":["location","summary"],"title":"SimpleAirportBriefingResponse"}}},"paths":{"/notams/briefing/simple":{"get":{"summary":"Generate simple airport briefing","description":"Returns an immediate, airport-focused NOTAM briefing: a readable summary of active notices for the requested airports, plus the NOTAM identifiers referenced.","parameters":[{"description":"Single ICAO airport code for the briefing. Multiple locations are not supported by this endpoint.","required":true,"deprecated":false,"schema":{"type":"string","maxLength":4,"minLength":3,"pattern":"^[A-Za-z0-9]{3,4}$","title":"Location","description":"Single ICAO airport code for the briefing. Multiple locations are not supported by this endpoint."},"name":"location","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"Start datetime for the briefing window. Accepts YYYY-MM-DD or full ISO datetime. Defaults to the start of the selected UTC day.","required":false,"deprecated":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At","description":"Start datetime for the briefing window. Accepts YYYY-MM-DD or full ISO datetime. Defaults to the start of the selected UTC day."},"name":"starts_at","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"End datetime for the briefing window. Accepts YYYY-MM-DD or full ISO datetime. Defaults to the end of the selected UTC day.","required":false,"deprecated":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At","description":"End datetime for the briefing window. Accepts YYYY-MM-DD or full ISO datetime. Defaults to the end of the selected UTC day."},"name":"ends_at","in":"query","allowEmptyValue":false,"allowReserved":false},{"description":"Briefing verbosity. Supported values: concile, detailed.","required":false,"deprecated":false,"schema":{"type":"string","title":"Type","description":"Briefing verbosity. Supported values: concile, detailed.","default":"concile"},"name":"type","in":"query","allowEmptyValue":false,"allowReserved":false}],"responses":{"200":{"description":"Airport briefing generated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimpleAirportBriefingResponse"}}}},"404":{"description":"No NOTAMs available for the given parameters","content":{"application/json":{"schema":{"properties":{"error":{"type":"string"}},"type":"object"}}}}},"deprecated":false}}}}
```