Nordtinde API

Connect your website or system to Nordtinde. Display homes, manage your own prices and calendar, and receive booking updates. Guests still book on Nordtinde.

Get started in 3 steps

1. Sign in and open Hosting → API access.
2. Create a key. Choose Read only to display your homes, or Read + write to edit them.
3. Copy the key once, save it securely, and include it in each request as shown below.

Your first request

curl https://YOUR-NORDTINDE-DOMAIN/api/public/v1/listings \
  -H "Authorization: Bearer ns_live_YOUR_KEY"

Replace ns_live_YOUR_KEY with your key. A successful response is JSON with a data list of your published homes.

const res = await fetch("https://YOUR-NORDTINDE-DOMAIN/api/public/v1/listings", {
  headers: { Authorization: "Bearer ns_live_YOUR_KEY" },
});
const { data } = await res.json();

curl -X PATCH https://YOUR-NORDTINDE-DOMAIN/api/public/v1/listings/LISTING_ID/price \
  -H "Authorization: Bearer ns_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nightly_price": 1500}'

Keep keys on your server, not in public website code. Booking access is an optional permission when creating a key. Full catalog access needs a separate application and approval.

What can you do?

Base URL: https://YOUR-NORDTINDE-DOMAIN/api/public/v1. All prices are in NOK.

• GET /bookings?limit=50&offset=0Booking access

  Get dates, status, guest counts and prices for your host bookings.

  Examples and technical details

  Read reservations where you are the host, including draft homes. Requires explicit booking access on the key. Optional listing_id (UUID), status, from and to (valid YYYY-MM-DD dates). Date filters select stays overlapping [from,to); checkout on from and check-in on to are excluded. Status: requested, pending_payment, confirmed, declined, cancelled, expired, completed. limit 1–100 (default 50), offset 0–100000 (default 0). Newest first, with id as tie-breaker. Follow next_offset until null; offset pagination may shift during concurrent inserts, so deduplicate by id.

  Example response (selected fields)

  {
    "data": [{
      "id": "BOOKING_UUID", "listing_id": "LISTING_UUID", "status": "confirmed",
      "check_in": "2027-08-01", "check_out": "2027-08-05",
      "adults": 2, "children": 0, "infants": 0, "pets": 0, "nights": 4,
      "total": 5936, "currency": "NOK", "host_payout": 5141,
      "created_at": "2026-11-02T10:00:00Z", "updated_at": "2026-11-02T10:00:00Z"
    }],
    "pagination": { "limit": 50, "offset": 0, "next_offset": null }
  }

• GET /listingsRead key

  Get your published homes and their basic details.

  Examples and technical details

  Your published listings (summary fields, no photos/amenities/house_rules).

  Example response (selected fields)

  {
    "data": [
      {
        "id": "130f42b8-…",
        "title": "Fjord-edge cabin with sauna",
        "city": "Balestrand",
        "nightly_price": 1200,
        "cleaning_fee": 500,
        "instant_book": true,
        "cover_photo": "https://…/cover.jpg",
        "booking_url": "https://nordtinde…/stays/130f42b8-…"
      }
    ]
  }

• GET /listings/{id}Read key

  Get one of your homes with photos, amenities and house rules.

  Examples and technical details

  One listing with photos, amenities and house rules.

  Example response (selected fields)

  {
    "data": {
      "id": "130f42b8-…",
      "title": "Fjord-edge cabin with sauna",
      "description": "Timber cabin on the water's edge …",
      "photos": [{ "url": "https://…/1.jpg", "caption": "Living room" }],
      "amenities": ["Sauna", "Wi-Fi", "Fireplace"],
      "house_rules": ["No smoking", "Quiet hours 23:00–07:00"],
      "booking_url": "https://nordtinde…/stays/130f42b8-…"
    }
  }

• GET /listings/{id}/availability?from=YYYY-MM-DD&to=YYYY-MM-DDRead key

  Check which nights are available and what they cost.

  Examples and technical details

  Each night with available true/false and price. Max 366 days.

  Example response (selected fields)

  {
    "data": [
      { "date": "2027-08-01", "available": true, "price": 1200 },
      { "date": "2027-08-02", "available": false, "price": 1200 },
      { "date": "2027-08-03", "available": true, "price": 1500 }
    ]
  }

• GET /listings/{id}/quote?check_in=YYYY-MM-DD&check_out=YYYY-MM-DDRead key

  Get the total price for a stay, including fees.

  Examples and technical details

  Price breakdown for a stay, same math as Nordtinde checkout. weekly_discount and monthly_discount are savings in NOK already deducted from nights_total. For 28+ nights a nonzero monthly discount replaces the weekly discount; otherwise the weekly discount applies from 7 nights. Discounts apply to nightly prices including overrides, not cleaning or extras. Fees are calculated after the discount.

  Example response (selected fields)

  {
    "data": {
      "check_in": "2027-08-01",
      "check_out": "2027-08-05",
      "available": true,
      "min_nights": 2,
      "currency": "NOK",
      "nights": 4,
      "nights_total": 4800,
      "weekly_discount": 0,
      "monthly_discount": 0,
      "cleaning_fee": 500,
      "service_fee": 636,
      "total": 5936,
      "booking_url": "https://nordtinde…/stays/130f42b8-…?check_in=2027-08-01&check_out=2027-08-05"
    }
  }

• PATCH /listings/{id}Read + write key

  Change your home's title, description, capacity and other settings.

  Examples and technical details

  Edit listing properties. Body may include any of: title, description, property_type, max_guests, max_infants, max_pets, bedrooms, beds, bathrooms, cleaning_fee, min_nights, instant_book, pets_allowed, check_in_time (HH:MM), check_out_time (HH:MM), cancellation_policy, calendar_closed_by_default. Location, photos and publishing can only be changed on Nordtinde.

  Request body

  {
    "title": "Fjord-edge cabin with sauna",
    "min_nights": 3,
    "pets_allowed": true
  }

  Example response (selected fields)

  {
    "data": {
      "id": "130f42b8-…",
      "updated": ["title", "min_nights", "pets_allowed"]
    }
  }

• PATCH /listings/{id}/priceRead + write key

  Change your nightly price, weekly discount or monthly discount.

  Examples and technical details

  Set the base nightly price, weekly discount and/or monthly discount. All fields optional, at least one required. Price in NOK, 100–100 000; discounts are integer percentages 0–90. Weekly applies from 7 nights; a nonzero monthly discount replaces weekly from 28 nights. Set a discount to 0 to disable it.

  Request body

  {
    "nightly_price": 1500,
    "weekly_discount_percent": 10,
    "monthly_discount_percent": 20
  }

  Example response (selected fields)

  {
    "data": {
      "id": "130f42b8-…",
      "nightly_price": 1500,
      "weekly_discount_percent": 10,
      "monthly_discount_percent": 20
    }
  }

• POST /listings/{id}/availabilityRead + write key

  Block or open dates, or change prices for specific nights.

  Examples and technical details

  Adjust the calendar. "to" is the checkout day (not included). set_price requires price (NOK, 100–100 000). Nights that are booked or synced from other sites can't be changed.

  Request body

  {
    "action": "block",
    "from": "2027-08-01",
    "to": "2027-08-05"
  }
  
  // or: { "action": "set_price", "from": "2027-08-10", "to": "2027-08-12", "price": 1800 }
  // actions: "block" | "unblock" | "set_price" | "reset_price"

  Example response (selected fields)

  {
    "data": { "action": "block", "from": "2027-08-01", "to": "2027-08-05", "changed": 4 }
  }

{
  "id": "EVENT_UUID", "type": "booking.status_changed", "api_version": "v1",
  "created_at": "2026-11-02T10:00:00Z",
  "data": {
    "id": "BOOKING_UUID", "listing_id": "LISTING_UUID", "status": "confirmed",
    "previous_status": "requested", "check_in": "2027-08-01", "check_out": "2027-08-05",
    "adults": 2, "children": 0, "infants": 0, "pets": 0, "total": 5936, "currency": "NOK"
  }
}

// Node.js receiver: keep the signing secret in your server's secret store.
import { createHmac, timingSafeEqual } from "node:crypto";
function verifyNordtinde(rawBody, headers, secret) {
  const stamp = headers["x-nordistay-timestamp"];
  const signature = headers["x-nordistay-signature"];
  if (!/^\d+$/.test(stamp ?? "") || !/^v1=[0-9a-f]{64}$/.test(signature ?? "")) return false;
  if (Math.abs(Date.now() / 1000 - Number(stamp)) > 300) return false;
  const expected = createHmac("sha256", secret).update(stamp + "." + rawBody).digest();
  const received = Buffer.from(signature.slice(3), "hex");
  return expected.length === received.length && timingSafeEqual(expected, received);
}
// Verify BEFORE parsing JSON. Use the exact raw UTF-8 request body.
// Header: X-Nordistay-Event-Id matches payload.id.
// Save payload.id atomically; duplicates should return 2xx without reprocessing.
// webhook.test has data: {}; booking.created has previous_status: null.

{ "error": { "code": "forbidden", "message": "An approved catalog application and catalog key are required" } }