Dreamify Partner API v1

Push your listings into Dreamify destinations (Experiences, Deals, Shop, Learn, Rent, Local…). Base URL https://dreamify-partner-api.netlify.app. Auth: Authorization: Bearer dpk_test_…. Test keys are sandbox-only and never public.

openapi.json · listing JSON Schema · TypeScript types · taxonomy · samples: sample-listings.json, sample-feed.csv

Quick start

Who am I

curl -s https://dreamify-partner-api.netlify.app/v1/me -H "Authorization: Bearer $DREAMIFY_KEY"

Taxonomy (types, destinations, categories, cities)

curl -s https://dreamify-partner-api.netlify.app/v1/taxonomy

Validate (dry run)

curl -s -X POST https://dreamify-partner-api.netlify.app/v1/listings:validate -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: application/json" --data @sample-listings.json

Upsert a batch

curl -s -X PUT https://dreamify-partner-api.netlify.app/v1/listings -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: application/json" -H "Idempotency-Key: batch-2026-10-15-01" --data @sample-listings.json

List pending

curl -s "https://dreamify-partner-api.netlify.app/v1/listings?status=pending_review&limit=20" -H "Authorization: Bearer $DREAMIFY_KEY"

Patch one

curl -s -X PATCH https://dreamify-partner-api.netlify.app/v1/listings/sample-tour-001 -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: application/json" -d '{"price":{"amount_cents":7900}}'

Request promotion (Preferred/Premier)

curl -s -X POST https://dreamify-partner-api.netlify.app/v1/listings/sample-tour-001:promote -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: application/json" -d '{"surfaces":["deals","marketplace"]}'

Remove one

curl -s -X DELETE https://dreamify-partner-api.netlify.app/v1/listings/sample-tour-001 -H "Authorization: Bearer $DREAMIFY_KEY"

Run a feed with an uploaded CSV

curl -s -X POST https://dreamify-partner-api.netlify.app/v1/feeds/$FEED_ID:run -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: text/csv" --data-binary @sample-feed.csv

Register a webhook

curl -s -X POST https://dreamify-partner-api.netlify.app/v1/webhooks -H "Authorization: Bearer $DREAMIFY_KEY" -H "Content-Type: application/json" -d '{"url":"https://partner.example/hooks/dreamify"}'

Statuses

pending_review → published (live, public) or approved (test env / partner not active) · rejected (see review_notes) · paused · expired · removed. Same vocabulary as Dreamify for Business publishing.