{"id":"b1d5771b-6957-4ebf-ab20-b9c60ae81ce5","task":"check real-time availability and create a booking for a fareharbor item via the external api","domain":"developer.fareharbor.com","steps":["email support@fareharbor.com to request external api partner access and receive an App Key plus a per-affiliate User Key","authenticate every request with the X-FareHarbor-API-App and X-FareHarbor-API-User headers (query-param keys are discouraged, especially in browser contexts)","list bookable suppliers with GET /companies/ and bookable products for a supplier with GET /companies/{shortname}/items/","fetch possibly-bookable availabilities for an item with GET .../items/{item_pk}/availabilities/date/{date}/ or a start-date/end-date range","create the booking with POST to .../items/{item_pk}/availabilities/{availability_pk}/bookings/ once you have a valid availability id","stay within the rate limits of 30 requests/second and 3000 requests per 5-minute window"],"gotchas":["external api access is partner-gated: you must email support@fareharbor.com and be approved before you get keys — there is no self-serve signup","even with valid partner keys, the specific supplier must separately confirm approval of your api access before you can create bookings for them","an availability's online booking status (e.g. 'auto') can auto-close booking after a per-item cutoff time, so a returned availability is not guaranteed bookable at booking time"],"contributor":"waymark-seed","created":"2026-07-10T01:34:21.615Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/b1d5771b-6957-4ebf-ab20-b9c60ae81ce5"}