Bindle API

{
  "matches": [
    {
      "id": "usr_hobo_42",
      "display_name": "Railroad Rita",
      "age": 47,
      "gender": "female",
      "compatibility_score": 0.87,
      "compatibility_breakdown": {
        "dumpster_preference_match": 0.92,
        "cardboard_box_compatibility": 0.85,
        "bean_sharing_willingness": 0.95,
        "rail_route_overlap": 0.78
      },
      "distance": "0.3 miles",
      "location_type": "Under bridge (south side)",
      "verified_assets": ["shopping_cart", "tent_2_person"],
      "looking_for": "Someone to share a fire barrel with",
      "deal_breakers": ["No tent", "Won't share beans"]
    }
  ],
  "total": 23
}

{
  "target_user_id": "usr_hobo_42",
  "direction": "right", // "right" = interested, "left" = pass
  "super_swipe": false, // Costs 1 extra can
  "message": "Nice cart! Is that a Safeway or Costco model?"
}

{
  "swipe_id": "swp_abc123",
  "is_match": true,
  "match_id": "mtch_xyz789",
  "suggested_meeting_spot": {
    "type": "fire_barrel",
    "location": "Under I-405, near the good dumpster",
    "lat": 37.7751,
    "lng": -122.4189
  },
  "celebration_message": "It's a match! May your bindles intertwine."
}

{
  "overall_score": 0.87,
  "factors": {
    "lifestyle": {
      "dumpster_territory_overlap": 0.92,
      "preferred_bridge_orientation": 0.88,
      "cardboard_box_dimensions": 0.75,
      "fire_barrel_sharing_style": 0.90
    },
    "travel": {
      "rail_route_compatibility": 0.78,
      "freight_vs_passenger_preference": 0.95,
      "travel_pace": 0.82
    },
    "culinary": {
      "bean_brand_preference": 0.91,
      "mulligan_stew_recipe_similarity": 0.67,
      "dumpster_dive_schedule": 0.89
    },
    "assets": {
      "combined_cart_capacity": 0.85,
      "tent_compatibility": 0.92,
      "bindle_stick_craftsmanship": 0.78
    }
  },
  "recommendation": "Strong match. Your dumpster schedules align perfectly.",
  "warnings": ["Slight mulligan stew recipe conflict - discuss before cohabitation"]
}

{
  "items": [
    {
      "id": "itm_001",
      "name": "Lucky Harmonica",
      "category": "entertainment",
      "condition": "well-loved",
      "shareable": true,
      "estimated_value_cans": 3
    },
    {
      "id": "itm_002",
      "name": "Slightly Dented Can of Beans",
      "category": "food",
      "expiration": "best_guess_2019",
      "shareable": true
    },
    {
      "id": "itm_003",
      "name": "Bindle Stick (Oak)",
      "category": "essential",
      "craftsmanship_score": 0.89,
      "shareable": false
    }
  ],
  "total_items": 12,
  "estimated_total_value_cans": 23
}

{
  "partner_1_id": "usr_hobo_42",
  "partner_2_id": "usr_hobo_87",
  "ceremony_type": "fire_barrel", // or "boxcar", "under_bridge", "jungle"
  "vows": {
    "partner_1": "I promise to share my beans and never hog the fire barrel.",
    "partner_2": "I promise to let you have the good side of the cardboard."
  },
  "witnesses": ["usr_hobo_23", "usr_hobo_45"]
}

{
  "ceremony_id": "cer_love2024",
  "status": "completed",
  "certificate_url": "https://cdn.bindle.vagibond.com/certificates/cer_love2024.pdf",
  "legal_status": "Not recognized in any jurisdiction",
  "romantic_status": "Eternally bound by the sacred fire barrel",
  "combined_bindle_inventory": 24,
  "message": "May your bindles always be full and your fire barrels always warm."
}

{
  "asset_type": "shopping_cart",
  "brand": "Costco", // Premium brand, +15% match rate
  "condition": "three_wheels",
  "photo_url": "https://your-server.com/my-cart.jpg",
  "acquisition_method": "found" // "found", "inherited", "traded", "other"
}