An API that already knows what a match is.

# A member likes someone. The reply says if it's a match.
curl -X PUT https://platform.datingapi.io/v1/me/likes/mbr_8f2k1 \
  -H "Authorization: Bearer $MEMBER_TOKEN" \
  -d '{"liked": true}'

{
  "liked": true,
  "matched": true,
  "member": { "id": "mbr_8f2k1", "name": "Maya", "age": 29,
              "identity_verified": true, "network": false }
}

// Up to 25 fresh people this member hasn't liked or passed
const res = await fetch(`${API}/v1/me/search/deck`, {
  method: "POST",
  headers: { Authorization: `Bearer ${memberToken}` },
  body: JSON.stringify({ age_min: 27, age_max: 38, distance_km: 25 })
});
const { members } = await res.json();
// members[0] → { id, name, age, photos, online, identity_verified, network }

// Swift: send a reply. Safe to retry for 24 hours.
var req = URLRequest(url: api.appending(path: "v1/me/messages/\(memberId)/replies"))
req.httpMethod = "POST"
req.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")
req.setValue(UUID().uuidString, forHTTPHeaderField: "Idempotency-Key")
req.httpBody = try JSONEncoder().encode(["body": "Swim at 8? I'm in."])
let (data, _) = try await URLSession.shared.data(for: req)

// Kotlin: start a government ID check, then poll for the result
val start = api.post("/v1/me/identity-verifications")
openInAppBrowser(start.url)

val result = api.get("/v1/me/identity-verification")
if (result.status == "verified") showBadge()
// identity_verified is now true on this member