> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airrating.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget Score

> Lightweight endpoint for the embeddable AirRating badge.

## Overview

Powers the embeddable `widget.js` badge. Returns a minimal risk score payload optimised for frontend rendering. Open CORS — can be called directly from any domain.

Responses are cached for 1 hour (`s-maxage=3600`).

## Request

<ParamField query="origin" type="string" required>
  IATA code of the departure airport.
</ParamField>

<ParamField query="dest" type="string" required>
  IATA code of the arrival airport.
</ParamField>

<ParamField query="airline" type="string" required>
  IATA airline code.
</ParamField>

<ParamField query="date" type="string" required>
  Departure date in `YYYY-MM-DD` format.
</ParamField>

<ParamField query="key" type="string">
  Your API key (optional during beta).
</ParamField>

## Response

<ResponseField name="origin" type="string">IATA departure airport code.</ResponseField>
<ResponseField name="destination" type="string">IATA arrival airport code.</ResponseField>
<ResponseField name="airline" type="string">IATA airline code.</ResponseField>
<ResponseField name="date" type="string">Requested date.</ResponseField>
<ResponseField name="score" type="integer">Risk Score 0–100.</ResponseField>
<ResponseField name="label" type="string">Risk label: `Low risk`, `Medium risk`, `High risk`, or `Very high risk`.</ResponseField>
<ResponseField name="color" type="string">Hex color for the score badge (green → red).</ResponseField>
<ResponseField name="delay_rate" type="integer">Historical delay rate as a whole percentage.</ResponseField>

## Example

```bash theme={null}
curl "https://airrating.io/api/widget-score?origin=FCO&dest=LHR&airline=AZ&date=2026-04-10"
```

```json Response theme={null}
{
  "origin": "FCO",
  "destination": "LHR",
  "airline": "AZ",
  "date": "2026-04-10",
  "score": 62,
  "label": "High risk",
  "color": "#f97316",
  "delay_rate": 33
}
```

## Embedding the widget

Add the script tag once per page and place one or more `div.airrating-widget` elements wherever you want the badge to appear:

```html theme={null}
<div class="airrating-widget"
     data-origin="FCO"
     data-dest="LHR"
     data-airline="AZ"
     data-date="2026-04-10"
     data-key="YOUR_API_KEY">
</div>
<script src="https://airrating.io/widget.js" async></script>
```

### Widget attributes

| Attribute      | Required | Default | Description         |
| -------------- | -------- | ------- | ------------------- |
| `data-origin`  | ✓        | —       | IATA departure code |
| `data-dest`    | ✓        | —       | IATA arrival code   |
| `data-airline` | ✓        | —       | IATA airline code   |
| `data-date`    | ✓        | —       | Date (`YYYY-MM-DD`) |
| `data-key`     | —        | —       | API key             |
| `data-size`    | —        | `full`  | `full` or `compact` |
| `data-theme`   | —        | `dark`  | `dark` or `light`   |
| `data-lang`    | —        | `en`    | `en`, `it`, or `es` |

<Tip>
  The widget disappears silently on any error — no broken UI on your page.
</Tip>