Get rating dictionary

Return the full airplane rating catalog so you can map the keys that appear in rating_breakdown to human-readable labels (e.g. type_a320 to “A320”). The payload is stable and suitable for client-side caching.

GET /v1/rating-dictionary

Required scope: rating-dictionary. This scope is off by default and must be enabled on your API key. Contact support@skyden.app if you need it.

Request

curl

curl -X GET \
  "https://api.skyden.app/functions/v1/api/v1/rating-dictionary" \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const res = await fetch(
  "https://api.skyden.app/functions/v1/api/v1/rating-dictionary",
  { headers: { Authorization: `Bearer ${process.env.SKYDEN_API_KEY}` } },
);
const { data } = await res.json();
const labels = Object.fromEntries(data.ratings.map((r) => [r.key, r.label]));

Python

import os, requests

res = requests.get(
    "https://api.skyden.app/functions/v1/api/v1/rating-dictionary",
    headers={"Authorization": f"Bearer {os.environ['SKYDEN_API_KEY']}"},
)
ratings = res.json()["data"]["ratings"]
labels = {r["key"]: r["label"] for r in ratings}

Response

200 OK

{
  "data": {
    "ratings": [
      {
        "key": "sep_land",
        "label": "SEP (land)",
        "category": "class_rating"
      },
      {
        "key": "mep_land",
        "label": "MEP (land)",
        "category": "class_rating"
      },
      {
        "key": "type_a320",
        "label": "A320",
        "category": "type_rating",
        "manufacturer": "Airbus"
      },
      {
        "key": "type_b737_300_900",
        "label": "B737 300-900",
        "category": "type_rating",
        "manufacturer": "Boeing"
      }
    ]
  },
  "meta": {
    "api_version": "v1",
    "request_id": "req_1a2b3c4d"
  }
}

Caching

The response is served with Cache-Control: private, max-age=3600. The catalog changes rarely (typically when we add support for a new aircraft type), so clients can safely cache it for an hour or more and refetch only when they see an unknown key in a rating_breakdown response.

Errors specific to this endpoint

Code	Status	Meaning
INSUFFICIENT_SCOPE	403	Your API key doesn’t have the rating-dictionary scope

See Errors for the full list of common error codes.

Field reference

Field	Description
key	Stable rating identifier. The same string that appears as a key in rating_breakdown.
label	Short human-readable name (e.g. A320, SEP (land)). English only.
category	One of class_rating, type_rating, or other.
manufacturer	Airframer name for type ratings (e.g. Airbus, Boeing). Omitted for class ratings.

Coverage

Only airplane ratings are exposed. Helicopter and sailplane hours are not included in rating_breakdown and are correspondingly not present in the dictionary.