Endpoint reference matrix

Every endpoint in this book in one place, with its status and the chapter that covers it.

MarkerMeaning
🟢Used by a client maintained in 2025–2026
🟡Only seen in 2020–2024 material
🔴Pre-2020, very likely broken
💳Paid subscription
⚠️Irreversible

Authentication

MethodPathStatusChapter
POST/v3/auth/login (protobuf)🟢2
POST/v2/auth/sms/send🟡2
POST/v2/auth/sms/validate🟡2
POST/v2/auth/login/sms🟡2
POST/v2/auth/login/facebook🔴2
POST/auth (Facebook)🔴2
POST/v2/auth/verify-captcha🟡9
POST/v2/auth/logout🟡9

Profile and account

MethodPathStatusChapter
GET/v2/profile?include=…🟢4
POST/v2/profile🟢4
POST/v2/profile/user🟢 💳4
DELETE/v2/profile ⚠️🟡4
GET / POST/profile🔴4
PUT / DELETE/profile/job, /profile/school🔴4
POST/v2/profile/job, /v2/profile/school🟡4
PUT / DELETE/profile/username🔴4
GET/profile/photos🟡4
DELETE/media🟡4
POST/v2/profile/email_settings🟡4
POST/v2/account/account-email/confirm🟡4
POST/v2/account/recovery/send🟡4
GET/user/{id}🟡4

Discovery and interactions

MethodPathStatusChapter
GET/v2/recs/core🟢5
GET/user/recs🔴5
GET/v2/explore🟡5
POST (current) · GET (legacy)/like/{id}🟢6
GET (current) · POST (2023 client)/pass/{id}🟢6
POST/like/{id}/super🟢 💳6
POST/boost🟢 💳6
POST/message/{id}/like🔴6

Matches and messages

MethodPathStatusChapter
GET/v2/matches🟢7
GET/v2/matches/{id}/messages🟢7
POST/user/matches/{id} (send)🟢7
DELETE/user/matches/{id} (unmatch)🟢7
GET/matches/{id}🟡7
GET/message/{id}🟡7
POST / GET/updates🔴7
GET/ws/generate + wss://keepalive.gotinder.com/ws🟡7

Location and meta

MethodPathStatusChapter
POST/v2/meta (location + meta)🟢8
GET/v2/meta, /meta🔴8
POST/user/ping🔴8
POST/passport/user/travel, /passport/user/reset🔴 💳8
GET/location/popular🟡8

Other

MethodPathStatusChapter
POST / GET/v2/fast-match/count🟡 💳9
GET/v2/fast-match/teaser(s)🟡9
GET/v2/fast-match/preview🔴9
GET/v2/my-likes🟡9
PUT/v2/push/notifications🟡9
POST / DELETE/v2/push/devices/web/{code}🟡9
GET/giphy/trending, /giphy/search🔴9
GET / POST/instagram/…🔴9
GET / PUT/v2/profile/spotify…🔴9
POST/report/{id}, /report/user/{id}🔴9
GET/user/{id}/common_connections🔴9
POST/user/{id}/share🔴9
GET/group/friends🔴9
GET/v1/activity/feed🔴9
POST/v2/incentives/eligibility🟡9
–/v2/onboarding/… (sign-up)Out of scope9