Partner API v1

One API To Bundle Nannies & Babysitters Into Your Travel Offering

The Holiday Nannies Partner API gives hotels, OTAs, and travel platforms direct access to vetted nannies, real-time availability, booking management, and live session tracking across 20+ destinations.

20+
Destinations
REST
JSON API
1,000
req/min rate limit
TLS 1.3
Encrypted transport

Core endpoints

Everything you need to search nannies, manage bookings, and surface live session data to your guests.

GET/destinations

List available destinations and partner-specific rate cards.

GET/nannies

Search vetted nannies by destination, date, language, and specialisation.

GET/availability

Check nanny availability across a date range — up to 30 days.

POST/bookings

Create a booking with specific nanny or best-available matching.

PATCH/bookings/{id}

Modify confirmed bookings — time, location, children details.

GET/analytics/summary

Aggregated performance metrics — bookings, ratings, care hours.

Built for travel platforms

Designed for hotels, OTAs, and concierge platforms that need reliable, real-time childcare infrastructure.

Real-time availability

Query nanny availability across a 30-day window and receive live status updates during care sessions.

Webhooks

Subscribe to events — booking confirmations, nanny match, session start, photo updates, and overtime — delivered to your endpoint in real time.

HMAC-signed payloads

Every webhook is signed with HMAC-SHA256 so you can verify authenticity before processing.

Multi-language support

Request nanny bios and destination descriptions in English, Korean, Japanese, or Chinese via Accept-Language header.

Prepaid or invoice billing

Partners on prepaid credit get preferred rates and priority matching. Invoice billing is available for high-volume accounts.

Sandbox environment

Test your integration end-to-end with sandbox keys that return mock data and never create real bookings.

Simple authentication

Every request requires a Bearer token in the Authorization header and your assigned X-Partner-ID. Sandbox keys (hn_test_...) return mock data — no real bookings are ever created.

  • API keys scoped to your contracted destinations
  • Separate sandbox and production environments
  • Idempotency keys on all POST requests
  • HMAC-signed webhooks with timestamp verification
HTTP
GET /v1/nannies?destination_id=boracay
Host: api.holidaynannies.com
Authorization: Bearer hn_live_k7x2m9p4...
X-Partner-ID: partner_abc123
Accept-Language: en

Ready to integrate?

API access is available to approved partners. Start with the full documentation or apply to become a partner today.

Questions? Email partners@holidaynannies.com