API reference

Insights

2 endpoints

Two computed dashboards, each a single call with no pagination. GET /api/v1/performance is post-trip quality: NPS, survey response rate, per-advisor breakdown, top suppliers and recent detractors over a window. GET /api/v1/retention is the forward view: anniversaries coming up, trips due a rebooking nudge, recent outreach and the referral codes that actually convert.

Both are computed fresh on every call rather than served from a cache, so treat them as a periodic pull, not a per-request lookup.

Post-trip quality snapshot

GET/api/v1/performance

Needs a key with the full scope.

Survey outcomes over a trailing window: how many invitations went out, how many were answered, the NPS that came back, the average segment rating, a per-advisor breakdown, the suppliers that scored best and the detractors worth calling.

Computed fresh on each call. Leave advisor_id off for the whole account.

Parameters

Query

window_daysenumdefault 90
Anything outside the allowed set falls back to 90.
one of306090180365
advisor_iduuid

Response · 200

dataobject
Show fieldsHide fields
- window_daysinteger
  The window actually used, after the allowlist.
- advisorobjectnullable
  Null when the snapshot covers the whole account.
  Show fieldsHide fields
  - iduuid
  - namestringnullable
  - emailstringnullable
- invitedinteger
  Survey invitations sent in the window.
- startedinteger
- completedinteger
- response_ratenumbernullable
  Completed over invited, as a percentage (62.5 means 62.5%).
- npsnumbernullable
  Net promoter score, -100 to 100.
- avg_segment_ratingnumbernullable
- per_advisorobject[]
  The same figures broken out per advisor.
- top_suppliersobject[]
- detractorsobject[]
  Recent low scorers, worth a call. comment is what the traveller wrote: a key whose role cannot see PII reads it as null, with content_masked: true.
- complimentaryobjectnullable
  Goodwill and complimentary service figures for the window.

Responses

401Missing or invalid Bearer token
403Policy denied or account has no owner
429Rate limit exceeded

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/performance' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/performance",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/performance",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/performance")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/performance");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Response

200

{
  "data": {
    "window_days": 90,
    "advisor": null,
    "invited": 1,
    "started": 1,
    "completed": 1,
    "response_rate": 1,
    "nps": 1,
    "avg_segment_rating": 1,
    "per_advisor": [
      {
        "advisor_id": "7a1c3e5b-2d4f-4b6a-9c8e-0f1a2b3c4d5e",
        "advisor_name": "Mert Demir",
        "invited": 24,
        "completed": 15,
        "response_rate": 62.5,
        "nps": 46.7,
        "avg_rating": 4.6,
        "complimentary": {
          "count": 2,
          "cost": 180,
          "cost_by_currency": {
            "EUR": 180
          }
        }
      }
    ],
    "top_suppliers": [
      {
        "supplier": "Museum Hotel",
        "reviews": 6,
        "avg_rating": 4.83
      }
    ],
    "detractors": [
      {
        "feedback_id": "3e8d1f6a-5c2b-4a9e-8f17-6b0d4c2a9e31",
        "trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
        "trip_title": "Cappadocia, 4 nights",
        "nps_score": 5,
        "comment": "The airport transfer was 40 minutes late.",
        "content_masked": false,
        "customer": "Ayşe Yılmaz",
        "submitted_at": "2026-03-20T18:05:00Z"
      }
    ],
    "complimentary": {
      "count": 3,
      "cost": 240,
      "cost_by_currency": {
        "EUR": 240
      }
    }
  }
}

Rebooking opportunities

GET/api/v1/retention