{
  "$schema": "./_mapping.schema.json",
  "provider": "resy",
  "name": "Resy (Resy OS)",
  "vertical": "restaurants",
  "verified_on": "2026-10-13",
  "docs": [
    {
      "title": "Resy OS integrations (marketing page)",
      "url": "https://resy.com/resyos/en_ca/integrations/",
      "note": "Lists existing partners (Toast, Square, Lightspeed, Micros Simphony, Loyalist, Fishbowl, …). No API reference, no webhook docs, no partner sign-up beyond 'Book a Consultation'."
    },
    {
      "title": "Tock Help Center: API FAQ",
      "url": "https://tock.zendesk.com/hc/en-us/articles/25447494175508-API-FAQ",
      "note": "Not Resy OS docs. Shows that Tock (now part of Resy / American Express) routes API and webhook requests to api-integration@resy.com, the only official Resy integration contact found."
    }
  ],
  "access": {
    "public_docs": false,
    "how_to_get_access": "No public developer portal or API reference exists. Ask Resy partnerships (via the Resy OS 'Book a Consultation' form, or api-integration@resy.com, the address Resy's Tock FAQ uses) for a partner agreement and docs. The consumer API at api.resy.com is undocumented and must not be used.",
    "unverified": true
  },
  "splitclub": {
    "integration_provider": "resy",
    "recommended_path": "webhook",
    "note": "Provisional: 'webhook' assumes Resy OS can push reservation changes to partners, which is not confirmed by any public Resy doc. The signature scheme is unknown, so SplitClub cannot add a check yet (today the hook only verifies Square signatures). For a Resy venue that also runs Tock, the Tock webhook (tock.json) is the documented route."
  },
  "objects": {
    "Offering": {
      "source": "Resy venue / table types / events (not publicly documented)",
      "kind": "table",
      "note": "Expected: seating types → Offering kind table; Resy events / ticketed experiences → ticketed_event. No field names can be confirmed.",
      "fields": [],
      "unverified": true
    },
    "PriceTier": {
      "source": "Resy deposits / cancellation fees / prepaid events (not publicly documented)",
      "fields": [],
      "unverified": true
    },
    "Availability": {
      "source": "Resy availability (not publicly documented)",
      "fields": [],
      "unverified": true
    },
    "Checkout": {
      "source": "Resy reservation (not publicly documented)",
      "fields": [],
      "unverified": true
    }
  },
  "webhooks": {
    "supported": null,
    "note": "No public Resy documentation mentions webhooks. Event names, payload and signature are unknown."
  },
  "gaps": [
    "Resy publishes no API reference: every object, field, event and auth detail needs a partner agreement and Resy's private docs.",
    "Webhook support and signature scheme unknown; SplitClub cannot add a signature check yet.",
    "Money, timezone, deposit and minimum-spend representations unknown.",
    "Resy and Tock are now one company; check with api-integration@resy.com whether Resy OS partners get the same Reservation Webhook as Tock."
  ]
}