Account

Create account via email, WIP

NOTE

This endpoint hasn't been researched yet

NOTE

URL is dynamic and currently unknown.

Body type: CreateAccountEmailRequest (undocumented).

Response type: FirstPartyCreateAccountResponse (undocumented).

POST /v?/users/registration/email

Validate password complexity, WIP

NOTE

This endpoint hasn't been researched yet

Body type: ValidatePasswordComplexityRequest (undocumented).

POST /v3/users/password-validation

Register FCM push token, WIP

NOTE

This endpoint hasn't been researched yet

Body type: FcmPushRequest (undocumented).

POST /v3/gcm-push-tokens

Update password, WIP

NOTE

This endpoint hasn't been researched yet

Body type: ChangePasswordRequest (undocumented).

Response type: ChangePasswordResponse (undocumented).

POST /v3/users/update-password

Update account email, WIP

NOTE

This endpoint hasn't been researched yet

Body type: UpdateEmailRequest (undocumented).

POST /v3/users/email

Response:

• profileId — string with numbers, account's ID
• sessionId — Session ID
• authToken — string, Auth token for session refresh

Update password via phone, WIP

NOTE

This endpoint hasn't been researched yet

Body type: ChangePasswordPhoneRequest (undocumented).

Response type: ChangePasswordResponse (undocumented).

POST /v4/sms/users/update-password

Create third party account, WIP

NOTE

This endpoint hasn't been researched yet

Creates a Grindr account for a third-party identity, used when Login via third party returns registered: false. The endpoint version is chosen from the first-party reCAPTCHA assignment: reCAPTCHA disabled → POST /v7/users/thirdparty (this endpoint); reCAPTCHA enabled → POST /v8/users/thirdparty, or POST /v8/dev/users/thirdparty when a dummy captcha token is used. The body is CreateThirdPartyAccountRequest in all variants.

Body type: CreateThirdPartyAccountRequest (undocumented).

Response type: ThirdPartyCreateAccountResponse (undocumented).

POST /v7/users/thirdparty

Forgot password, WIP

NOTE

This endpoint hasn't been researched yet

Body type: ForgotPwdEmailRequest (undocumented).

Response type: ForgotPwdEmailResponse (undocumented).

POST /v3/users/forgot-password

Create phone session, WIP

NOTE

This endpoint hasn't been researched yet

Body type: LoginPhoneRequest (undocumented).

POST /v4/sms/sessions

Response:

• profileId — string with numbers, account's ID
• sessionId — Session ID
• authToken — string, Auth token for session refresh

Get preferences

Requires Authorization.

GET /v3/me/prefs/settings

Response:

• profileId — integer
• locationSearchOptOut — boolean
• incognito — boolean
• hideViewedMe — boolean
• approximateDistance — boolean
• viewRightNowNsfw — boolean
• mapLocationFuzzRadius — integer, Map-location privacy fuzz radius. Renamed from mapLocationRadius in app 26.10.0. or null
• showOnMap — boolean, Whether the profile is shown on the map.

Set preferences

Requires Authorization.

PUT /v3/me/prefs/settings

Body:

• settings — object
  • locationSearchOptOut — boolean
  • incognito — boolean
  • hideViewedMe — boolean
  • approximateDistance — boolean
  • viewRightNowNsfw — boolean
  • showOnMap — boolean, Whether the profile is shown on the map.
  • mapLocationFuzzRadius — integer, Map-location privacy fuzz radius. Renamed from mapLocationRadius in app 26.10.0. or null

Response:

Empty.

Get visiting settings

Requires Authorization.

GET /v1/visiting/settings

Response:

• setting — string, visiting-status mode: OFF, ON, or AUTO

Set visiting settings

Requires Authorization.

PUT /v1/visiting/settings

Body:

• setting — string, visiting-status mode: OFF, ON, or AUTO

Response:

Empty.

Get home location

Requires Authorization.

GET /v1/visiting/home

Response:

• name — string, human-readable name of location
• lat — number
• lon — number

Set home location

Requires Authorization.

PUT /v1/visiting/home

Body:

• lat — number
• lon — number

Response:

• name — string, human-readable name of location
• lat — number
• lon — number

Create third party account (reCAPTCHA), WIP

NOTE

This endpoint hasn't been researched yet

reCAPTCHA-enabled variant of Create third party account (POST /v7/users/thirdparty), selected when the first-party reCAPTCHA assignment is enabled. POST /v8/dev/users/thirdparty is used instead when a dummy captcha token is supplied. The body is CreateThirdPartyAccountRequest in all variants.

Body type: CreateThirdPartyAccountRequest (undocumented).

Response type: ThirdPartyCreateAccountResponse (undocumented).

POST /v8/users/thirdparty

AccountPreferences

• profileId — integer
• locationSearchOptOut — boolean
• incognito — boolean
• hideViewedMe — boolean
• approximateDistance — boolean
• viewRightNowNsfw — boolean
• mapLocationFuzzRadius — integer, Map-location privacy fuzz radius. Renamed from mapLocationRadius in app 26.10.0. or null, optional
• showOnMap — boolean, Whether the profile is shown on the map., optional

AccountPreferencesUpdate

• settings — object
  • locationSearchOptOut — boolean
  • incognito — boolean
  • hideViewedMe — boolean
  • approximateDistance — boolean
  • viewRightNowNsfw — boolean
  • showOnMap — boolean, Whether the profile is shown on the map.
  • mapLocationFuzzRadius — integer, Map-location privacy fuzz radius. Renamed from mapLocationRadius in app 26.10.0. or null

VisitingSettings

• setting — string, visiting-status mode: OFF, ON, or AUTO

HomeLocation

• name — string, human-readable name of location
• lat — number
• lon — number

HomeLocationMutation

• lat — number
• lon — number