2B Local API

2B Local API documentation.

api

v1 > auth > apple > create

POST /api/v1/auth/apple/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`access_token` required	OAuth access token

v1 > auth > email > change > create

POST /api/v1/auth/email/change/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`email` required	New email address

v1 > auth > facebook > create

POST /api/v1/auth/facebook/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`access_token` required	OAuth access token

v1 > auth > google > create

POST /api/v1/auth/google/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`access_token` required	OAuth access token

POST /api/v1/auth/login/

Check the credentials and return the REST Token if the credentials are valid and authenticated. Calls Django Auth login method to register User ID in Django session framework Accept the following POST parameters: email, password Return the REST Framework Token Object's key.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`email` required	Email address
`password` required	Password

v1 > auth > logout > list

GET /api/v1/auth/logout/

Calls Django logout method and delete the Token object assigned to the current User object. Accepts/Returns nothing.

v1 > auth > logout > create

POST /api/v1/auth/logout/

Calls Django logout method and delete the Token object assigned to the current User object. Accepts/Returns nothing.

v1 > auth > password > change > create

POST /api/v1/auth/password/change/

Changes current user's password. Accepts the following POST parameters: old_password, new_password Returns the success/fail message.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`old_password` required	Current password
`new_password` required	New password

v1 > auth > password > reset > create

POST /api/v1/auth/password/reset/

Calls Django Auth PasswordResetForm save method. Accepts the following POST parameters: email Returns the success/fail message.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`email` required	Email address

v1 > auth > password > set > create

POST /api/v1/auth/password/set/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`password` required	New password

v1 > auth > register > create

POST /api/v1/auth/register/

Generic user registration.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`email` required	Email address
`password` required	Current password

v1 > auth > user > read

GET /api/v1/auth/user/

v1 > auth > verify-email > create

POST /api/v1/auth/verify-email/

Verify email if valid one time password given.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`key` required	4 digits key

v1 > auth > verify-email > resend > create

POST /api/v1/auth/verify-email/resend/

Resend email verification letter.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`email` required	Email address

v1 > blocks > list

GET /api/v1/blocks/

Get all users blocked by the current user.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > blocks > block > create

POST /api/v1/blocks/{id}/block/

Block or unblock a user with a custom queryset.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > blocks > block > delete

DELETE /api/v1/blocks/{id}/block/

Block or unblock a user with a custom queryset.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > connection-requests > list

GET /api/v1/connection-requests/

Get all new connection request for current user.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`cursor`	The pagination cursor value.

v1 > connection-requests > accept

PATCH /api/v1/connection-requests/{id}/accept/

Accept a connection request.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > connection-requests > decline

PATCH /api/v1/connection-requests/{id}/decline/

Decline a connection request.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > explore > list

GET /api/v1/explore/

Get random explore posts list

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > explore > events

GET /api/v1/explore/events/

v1 > explore > friends_events

GET /api/v1/explore/friends-events/

v1 > explore > local_events

GET /api/v1/explore/local-events/

v1 > explore > reels

GET /api/v1/explore/reels/

v1 > files > avatars > create

POST /api/v1/files/avatars/

Upload avatar.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`image` required

v1 > files > post-pictures > create

POST /api/v1/files/post-pictures/

Upload post picture.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`image` required

v1 > files > post-pictures > delete

DELETE /api/v1/files/post-pictures/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > files > reel > upload-url > list

GET /api/v1/files/reel/upload-url/

Generate presigned URL for frontend upload

v1 > guest > explore > list

GET /api/v1/guest/explore/

Get random explore public posts list

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > guest > explore > events

GET /api/v1/guest/explore/events/

v1 > guest > explore > reels

GET /api/v1/guest/explore/reels/

v1 > guest > explore > read

GET /api/v1/guest/explore/{id}/

Find a public post

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > guest > explore > comments > list

GET /api/v1/guest/explore/{post_pk}/comments/

Get comments list of a public post

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > invitation > email > create

POST /api/v1/invitation/email/

v1 > local-life > post > list

GET /api/v1/local-life/post/

Get locallife posts list

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.
`ordering`	Which field to use when ordering the results.

v1 > local-life > post > read

GET /api/v1/local-life/post/{id}/

Get a certain locallife post.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`ordering`	Which field to use when ordering the results.

v1 > locations > countries > list

GET /api/v1/locations/countries/

List of all available countries.

v1 > messenger > list

GET /api/v1/messenger/

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`cursor`	The pagination cursor value.

v1 > messenger > create

POST /api/v1/messenger/

If Conversation with this participants already exist, get one from DB and return 200 status code instead 201 :param request: :param args: :param kwargs: :return:

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`opponent` required

POST /api/v1/messenger/share/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`message` required
`recipients` required

v1 > messenger > read

GET /api/v1/messenger/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > messenger > delete

DELETE /api/v1/messenger/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > messenger > validate_access

GET /api/v1/messenger/{id}/validate-access/

Used by WebSocket server to check if the user has access to the conversation.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > messenger > messages > list

GET /api/v1/messenger/{conversation_pk}/messages/

Mark all new messages in conversation as read :param request: :param args: :param kwargs: :return:

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`conversation_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`cursor`	The pagination cursor value.

v1 > messenger > messages > create

POST /api/v1/messenger/{conversation_pk}/messages/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`conversation_pk` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text`	Message text
`type`	Message type
`image_url`	Image URL
`object_id`
`user_links`

v1 > messenger > messages > update

PUT /api/v1/messenger/{conversation_pk}/messages/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`conversation_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`status` required

v1 > messenger > messages > partial_update

PATCH /api/v1/messenger/{conversation_pk}/messages/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`conversation_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`status`

v1 > music > track > list

GET /api/v1/music/track/

v1 > music > track > read

GET /api/v1/music/track/{track_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`track_id` required

v1 > music > track > search > list

GET /api/v1/music/track/search/

v1 > music > track > search > read

GET /api/v1/music/track/search/{track_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`track_id` required

v1 > news > post > list

GET /api/v1/news/post/

Get news posts list

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.
`ordering`	Which field to use when ordering the results.

v1 > news > post > read

GET /api/v1/news/post/{id}/

Get a certain news post.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`ordering`	Which field to use when ordering the results.

v1 > notifications > list

GET /api/v1/notifications/

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`cursor`	The pagination cursor value.

v1 > notifications > checks

GET /api/v1/notifications/checks/

v1 > notifications > comments

GET /api/v1/notifications/comments/

v1 > notifications > likes

GET /api/v1/notifications/likes/

v1 > notifications > new

GET /api/v1/notifications/new/

v1 > notifications > device > fcm > list

GET /api/v1/notifications/device/fcm/

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > notifications > device > fcm > create

POST /api/v1/notifications/device/fcm/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`id`
`name`
`registration_id` required
`device_id`	ANDROID_ID / TelephonyManager.getDeviceId() (e.g: 0x01)
`active`	Inactive devices will not be sent notifications
`cloud_message_type`	You should choose FCM or GCM
`application_id`	Opaque application identity, should be filled in for multiple key/certificate access

v1 > notifications > device > fcm > read

GET /api/v1/notifications/device/fcm/{registration_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`registration_id` required

v1 > notifications > device > fcm > update

PUT /api/v1/notifications/device/fcm/{registration_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`registration_id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`id`
`name`
`registration_id` required
`device_id`	ANDROID_ID / TelephonyManager.getDeviceId() (e.g: 0x01)
`active`	Inactive devices will not be sent notifications
`cloud_message_type`	You should choose FCM or GCM
`application_id`	Opaque application identity, should be filled in for multiple key/certificate access

v1 > notifications > device > fcm > partial_update

PATCH /api/v1/notifications/device/fcm/{registration_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`registration_id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`id`
`name`
`registration_id`
`device_id`	ANDROID_ID / TelephonyManager.getDeviceId() (e.g: 0x01)
`active`	Inactive devices will not be sent notifications
`cloud_message_type`	You should choose FCM or GCM
`application_id`	Opaque application identity, should be filled in for multiple key/certificate access

v1 > notifications > device > fcm > delete

DELETE /api/v1/notifications/device/fcm/{registration_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`registration_id` required

v1 > posts > feed > list

GET /api/v1/posts/feed/

Get user's feed.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`cursor`	The pagination cursor value.

v1 > posts > feed > read

GET /api/v1/posts/feed/{id}/

Get a certain post in user's feed.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > posts > feed > add_to_calendar

POST /api/v1/posts/feed/{id}/add_to_calendar/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > check

POST /api/v1/posts/feed/{id}/check/

Add or delete check to a post.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > favorite

POST /api/v1/posts/feed/{id}/favorite/

Add or or remove post from user's favorites.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > join

POST /api/v1/posts/feed/{id}/join/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > like

POST /api/v1/posts/feed/{id}/like/

Add or delete like to a post.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > reminder

POST /api/v1/posts/feed/{id}/reminder/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`is_event`
`is_news`
`is_local_tip`
`is_reel`
`reel`
`is_local_update`
`is_draft`
`city_id`	Google Place ID. Max length: 255

v1 > posts > feed > checks > list

GET /api/v1/posts/feed/{post_pk}/checks/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > posts > feed > checks > create

POST /api/v1/posts/feed/{post_pk}/checks/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`id` required
`username` required
`first_name` required
`avatar` required

v1 > posts > feed > checks > delete

DELETE /api/v1/posts/feed/{post_pk}/checks/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`id` required

v1 > posts > feed > comments > list

GET /api/v1/posts/feed/{post_pk}/comments/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > posts > feed > comments > create

POST /api/v1/posts/feed/{post_pk}/comments/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text` required	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > update

PUT /api/v1/posts/feed/{post_pk}/comments/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text` required	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > partial_update

PATCH /api/v1/posts/feed/{post_pk}/comments/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text`	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > delete

DELETE /api/v1/posts/feed/{post_pk}/comments/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`id` required

v1 > posts > feed > comments > replies > list

GET /api/v1/posts/feed/{post_pk}/comments/{comment_pk}/replies/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`comment_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > posts > feed > comments > replies > create

POST /api/v1/posts/feed/{post_pk}/comments/{comment_pk}/replies/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`comment_pk` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text` required	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > replies > update

PUT /api/v1/posts/feed/{post_pk}/comments/{comment_pk}/replies/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`comment_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text` required	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > replies > partial_update

PATCH /api/v1/posts/feed/{post_pk}/comments/{comment_pk}/replies/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`comment_pk` required
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`text`	Maximum length is 1000 symbols
`user_links`

v1 > posts > feed > comments > replies > delete

DELETE /api/v1/posts/feed/{post_pk}/comments/{comment_pk}/replies/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`comment_pk` required
`id` required

v1 > posts > feed > joins > list

GET /api/v1/posts/feed/{post_pk}/joins/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > posts > feed > joins > create

POST /api/v1/posts/feed/{post_pk}/joins/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`id` required
`username` required
`first_name` required
`avatar` required

v1 > posts > feed > joins > delete

DELETE /api/v1/posts/feed/{post_pk}/joins/{id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`post_pk` required
`id` required

v1 > posts > my > list

GET /api/v1/posts/my/

My posts list.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > posts > my > create

POST /api/v1/posts/my/

Create a post.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`title` required	Maximum length is 255 symbols
`description` required
`tags` required
`categories` required	Choose at least one category
`visibility`
`pictures` required
`place` required	Google Places API `place_id` value
`lat_lng`	Custom place coordinates
`is_local_tip`
`is_local_update`
`is_event`
`is_reel`
`is_draft`
`event`
`reel`
`localupdate`
`city_id`	Google Place ID. Max length: 255
`user_links`

v1 > posts > my > precheck_is_local_tip

POST /api/v1/posts/my/precheck-is-local-tip/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`location` required
`place`

v1 > posts > my > read

GET /api/v1/posts/my/{id}/

Get post detail.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > posts > my > update

PUT /api/v1/posts/my/{id}/

Update post detail.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`title` required	Maximum length is 255 symbols
`description` required
`tags` required
`categories` required	Choose at least one category
`visibility`
`pictures` required
`place` required	Google Places API `place_id` value
`lat_lng`	Custom place coordinates
`is_local_tip`
`is_local_update`
`is_event`
`is_reel`
`is_draft`
`event`
`reel`
`localupdate`
`city_id`	Google Place ID. Max length: 255
`user_links`

v1 > posts > my > partial_update

PATCH /api/v1/posts/my/{id}/

Update post detail.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`title`	Maximum length is 255 symbols
`description`
`tags`
`categories`	Choose at least one category
`visibility`
`pictures`
`place`	Google Places API `place_id` value
`lat_lng`	Custom place coordinates
`is_local_tip`
`is_local_update`
`is_event`
`is_reel`
`is_draft`
`event`
`reel`
`localupdate`
`city_id`	Google Place ID. Max length: 255
`user_links`

v1 > posts > my > delete

DELETE /api/v1/posts/my/{id}/

Remove post.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required

v1 > profile > my > read

GET /api/v1/profile/my/

v1 > profile > my > create

POST /api/v1/profile/my/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username` required	Maximum length is 100 symbols
`first_name` required	Maximum length is 255 symbols
`last_name` required	Maximum length is 255 symbols
`avatar`	Avatar ID
`info`	Text information
`city_special`	What makes my city special
`website`
`place` required	Google Places API `place_id` value

v1 > profile > my > update

PUT /api/v1/profile/my/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username` required	Maximum length is 100 symbols
`first_name` required	Maximum length is 255 symbols
`last_name` required	Maximum length is 255 symbols
`avatar`	Avatar ID
`info`	Text information
`city_special`	What makes my city special
`website`
`place` required	Google Places API `place_id` value

v1 > profile > my > partial_update

PATCH /api/v1/profile/my/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username`	Maximum length is 100 symbols
`first_name`	Maximum length is 255 symbols
`last_name`	Maximum length is 255 symbols
`avatar`	Avatar ID
`info`	Text information
`city_special`	What makes my city special
`website`
`place`	Google Places API `place_id` value

v1 > profile > my > delete

DELETE /api/v1/profile/my/

v1 > profile > my > interests > read

GET /api/v1/profile/my/interests/

v1 > profile > my > interests > update

PATCH /api/v1/profile/my/interests/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`interests`

v1 > profile > my > local-tips > list

GET /api/v1/profile/my/local-tips/

v1 > profile > my > local-tips > read

GET /api/v1/profile/my/local-tips/{slug}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`slug` required

v1 > profile > my > network > all

GET /api/v1/profile/my/network/all/

v1 > profile > my > network > fof

GET /api/v1/profile/my/network/fof/

Get list of current user's friends of friends. Available search by username, first name and last name

v1 > profile > my > network > followers

GET /api/v1/profile/my/network/followers/

Get list of current user's followers. Available search by username, first name and last name

v1 > profile > my > network > following

GET /api/v1/profile/my/network/following/

Get list of users that current user followings. Available search by username, first name and last name

v1 > profile > my > network > friends

GET /api/v1/profile/my/network/friends/

Get list of current user's friends. Available search by username, first name and last name

v1 > profile > my > network > network

GET /api/v1/profile/my/network/network/

v1 > profile > my > notifications > read

GET /api/v1/profile/my/notifications/

Notifications action endpoint for retrieve and update notifications :return: Profile.notifications json field

v1 > profile > my > notifications > partial_update

PATCH /api/v1/profile/my/notifications/

Notifications action endpoint for retrieve and update notifications :return: Profile.notifications json field

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`notifications`

v1 > profile > my > posts > list

GET /api/v1/profile/my/posts/

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`
`city`
`city_id`
`place_id`

v1 > profile > my > posts > checks

GET /api/v1/profile/my/posts/checks/

v1 > profile > my > posts > events

GET /api/v1/profile/my/posts/events/

v1 > profile > my > posts > favorites

GET /api/v1/profile/my/posts/favorites/

v1 > profile > my > posts > join_events

GET /api/v1/profile/my/posts/join_events/

v1 > profile > my > posts > local_tips

GET /api/v1/profile/my/posts/local_tips/

v1 > profile > my > posts > local_updates

GET /api/v1/profile/my/posts/local_updates/

v1 > profile > my > posts > reels

GET /api/v1/profile/my/posts/reels/

v1 > profile > my > top-things > read

GET /api/v1/profile/my/top-things/

v1 > profile > my > top-things > update

PATCH /api/v1/profile/my/top-things/

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`top_things`

v1 > profile > my > wishlist > list

GET /api/v1/profile/my/wishlist/

ViewSet for managing wishlists including CRUD operations and custom actions.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.
`search`	A search term.

v1 > profile > my > wishlist > create

POST /api/v1/profile/my/wishlist/

ViewSet for managing wishlists including CRUD operations and custom actions.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`name` required
`is_private`
`is_default`

v1 > profile > my > wishlist > remove_post_from_wishlists

POST /api/v1/profile/my/wishlist/remove_post_from_wishlists/

ViewSet for managing wishlists including CRUD operations and custom actions.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`name` required
`is_private`
`is_default`

v1 > profile > my > wishlist > read

GET /api/v1/profile/my/wishlist/{id}/

ViewSet for managing wishlists including CRUD operations and custom actions.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required	A unique integer value identifying this wishlist.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`search`	A search term.

v1 > profile > my > wishlist > add_post

POST /api/v1/profile/my/wishlist/{id}/add_post/

ViewSet for managing wishlists including CRUD operations and custom actions.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required	A unique integer value identifying this wishlist.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`name` required
`is_private`
`is_default`

v1 > profile > my > wishlist > partial_updates

PATCH /api/v1/profile/my/wishlist/{id}/partial_updates/

Update the name and/or privacy status of a wishlist.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required	A unique integer value identifying this wishlist.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`name`
`is_private`
`is_default`

v1 > profile > my > wishlist > remove

DELETE /api/v1/profile/my/wishlist/{id}/remove/

Delete a wishlist.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required	A unique integer value identifying this wishlist.

v1 > profile > my > wishlist > remove_post

POST /api/v1/profile/my/wishlist/{id}/remove_post/

ViewSet for managing wishlists including CRUD operations and custom actions.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`id` required	A unique integer value identifying this wishlist.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`name` required
`is_private`
`is_default`

v1 > profile > my > wishlist > posts > list

GET /api/v1/profile/my/wishlist/{wishlist_pk}/posts/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`wishlist_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`
`city`
`place_id`

v1 > profiles > read

GET /api/v1/profiles/{username}/

Get public profile detail.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`username` required

v1 > profiles > connect > create

POST /api/v1/profiles/{username}/connect/

Send friendship request to profile or remove friendship.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`username` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username` required	Maximum length is 100 symbols
`first_name` required	Maximum length is 255 symbols
`last_name` required	Maximum length is 255 symbols
`avatar` required
`info`	Text information
`city_special`	What makes my city special
`website`	URL
`interests` required
`top_things` required
`connection_status` required
`is_followed` required

v1 > profiles > connect > delete

DELETE /api/v1/profiles/{username}/connect/

Send friendship request to profile or remove friendship.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`username` required

v1 > profiles > follow > create

POST /api/v1/profiles/{username}/follow/

Follow or unfollow user.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`username` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`username` required	Maximum length is 100 symbols
`first_name` required	Maximum length is 255 symbols
`last_name` required	Maximum length is 255 symbols
`avatar` required
`info`	Text information
`city_special`	What makes my city special
`website`	URL
`interests` required
`top_things` required
`connection_status` required
`is_followed` required

v1 > profiles > follow > delete

DELETE /api/v1/profiles/{username}/follow/

Follow or unfollow user.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`username` required

v1 > profiles > local-tips > list

GET /api/v1/profiles/{profile_username}/local-tips/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > local-tips > read

GET /api/v1/profiles/{profile_username}/local-tips/{slug}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required
`slug` required

v1 > profiles > network > all

GET /api/v1/profiles/{profile_username}/network/all/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > network > fof

GET /api/v1/profiles/{profile_username}/network/fof/

Get list of user's friends of friends. Available search by username, first name and last name

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > network > followers

GET /api/v1/profiles/{profile_username}/network/followers/

Get list of user's followers. Available search by username, first name and last name

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > network > following

GET /api/v1/profiles/{profile_username}/network/following/

Get list of users that user followings. Available search by username, first name and last name

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > network > friends

GET /api/v1/profiles/{profile_username}/network/friends/

Get list of user's friends. Available search by username, first name and last name

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > network > network

GET /api/v1/profiles/{profile_username}/network/network/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > list

GET /api/v1/profiles/{profile_username}/posts/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`
`city`
`city_id`
`place_id`

v1 > profiles > posts > checks

GET /api/v1/profiles/{profile_username}/posts/checks/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > events

GET /api/v1/profiles/{profile_username}/posts/events/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > favorites

GET /api/v1/profiles/{profile_username}/posts/favorites/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > join_events

GET /api/v1/profiles/{profile_username}/posts/join_events/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > local_tips

GET /api/v1/profiles/{profile_username}/posts/local_tips/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > local_updates

GET /api/v1/profiles/{profile_username}/posts/local_updates/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > posts > reels

GET /api/v1/profiles/{profile_username}/posts/reels/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

v1 > profiles > wishlist > posts > list

GET /api/v1/profiles/wishlist/{wishlist_pk}/posts/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`wishlist_pk` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`
`city`
`place_id`

v1 > profiles > wishlist > public > list

GET /api/v1/profiles/wishlist/{profile_username}/public/

ViewSet for managing wishlists including CRUD operations and custom actions.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > profiles > wishlist > public > read

GET /api/v1/profiles/wishlist/{profile_username}/public/{id}/

ViewSet for managing wishlists including CRUD operations and custom actions.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`profile_username` required
`id` required	A unique integer value identifying this wishlist.

v1 > reports > report_post

POST /api/v1/reports/post/

Endpoint to report a post. Prevents duplicate reports.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`reported_user` required
`reason` required
`description`

v1 > reports > report_user

POST /api/v1/reports/user/

Endpoint to report a user. Prevents duplicate reports.

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`reported_user` required
`reason` required
`description`

v1 > search > cities > list

GET /api/v1/search/cities/

Find city. Available query params: search and country (2 letters)

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`search`	A search term.

v1 > search > cities > near_me

GET /api/v1/search/cities/near-me/

v1 > search > cities > read

GET /api/v1/search/cities/{place_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`search`	A search term.

v1 > search > cities > events > list

GET /api/v1/search/cities/{city_place_id}/events/

Find Event posts in certain city. Find Friends Event posts in certain city. Query Param: action (optional) = "local_events" or "friends_events"

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > cities > fof > list

GET /api/v1/search/cities/{city_place_id}/fof/

Find friends of friends posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > cities > friends > list

GET /api/v1/search/cities/{city_place_id}/friends/

Find friends posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > cities > local-life > list

GET /api/v1/search/cities/{city_place_id}/local-life/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > search > cities > local-tips > list

GET /api/v1/search/cities/{city_place_id}/local-tips/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

v1 > search > cities > local-tips > read

GET /api/v1/search/cities/{city_place_id}/local-tips/{slug}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required
`slug` required

v1 > search > cities > local-tips-v2 > list

GET /api/v1/search/cities/{city_place_id}/local-tips-v2/

Find local tips in a certain city (Elasticsearch-based).

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > cities > locals > list

GET /api/v1/search/cities/{city_place_id}/locals/

Find profile in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`search`	Search in first_name, last_name, username.

v1 > search > cities > news > list

GET /api/v1/search/cities/{city_place_id}/news/

Find News posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`page_size`	Number of results to return per page.

v1 > search > cities > posts > list

GET /api/v1/search/cities/{city_place_id}/posts/

Find posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > cities > reels > list

GET /api/v1/search/cities/{city_place_id}/reels/

Find posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`city_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > keywords > list

GET /api/v1/search/keywords/

Find tag.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`search`	Search in title.
`city`
`category`

v1 > search > keywords > suggest

GET /api/v1/search/keywords/suggest/

Suggest functionality.

v1 > search > locations > list

GET /api/v1/search/locations/

Find city. Available query params: search and country (2 letters)

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`search`	A search term.

v1 > search > locations > near_me

GET /api/v1/search/locations/near-me/

v1 > search > locations > places

GET /api/v1/search/locations/places/

v1 > search > locations > read

GET /api/v1/search/locations/{place_id}/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`search`	A search term.

v1 > search > locations > check

POST /api/v1/search/locations/{place_id}/check/

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`place_id` required

Request Body

The request body should be a "application/json" encoded object, containing the following items.

Parameter	Description
`place_id` required

v1 > search > locations > posts > list

GET /api/v1/search/locations/{location_place_id}/posts/

Find posts in certain location.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`location_place_id` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`category`

v1 > search > profiles > list

GET /api/v1/search/profiles/

Find profile.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`search`	Search in first_name, last_name, username.

GET /api/v1/search/profiles/related/

v1 > search > profiles > starts_with

GET /api/v1/search/profiles/starts-with/

v1 > search > tags > list

GET /api/v1/search/tags/

Find tag.

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`search`	Search in name.

v1 > search > tags > posts > list

GET /api/v1/search/tags/{tag_slug}/posts/

Find posts in certain city.

Path Parameters

The following parameters should be included in the URL path.

Parameter	Description
`tag_slug` required

Query Parameters

The following parameters should be included as part of a URL query string.

Parameter	Description
`page`	A page number within the paginated result set.
`city`
`category`

common

email > test > list

GET /common/email/test/

Send one diagnostic email using the configured email backend. This endpoint is intentionally unauthenticated for local/configuration checks. The recipient is configured server-side to avoid creating an open email relay through a user-supplied address.

2B Local API

2B Local API

api

v1 > auth > apple > create

Request Body

v1 > auth > email > change > create

Request Body

v1 > auth > facebook > create

Request Body

v1 > auth > google > create

Request Body

v1 > auth > login > create

Request Body

v1 > auth > logout > list

v1 > auth > logout > create

v1 > auth > password > change > create

Request Body

v1 > auth > password > reset > create

Request Body

v1 > auth > password > set > create

Request Body

v1 > auth > register > create

Request Body

v1 > auth > user > read

v1 > auth > verify-email > create

Request Body

v1 > auth > verify-email > resend > create

Request Body

v1 > blocks > list

Query Parameters

v1 > blocks > block > create

Path Parameters

v1 > blocks > block > delete

Path Parameters

v1 > connection-requests > list

Query Parameters

v1 > connection-requests > accept

Path Parameters

v1 > connection-requests > decline

Path Parameters

v1 > explore > list

Query Parameters

v1 > explore > events

v1 > explore > friends_events

v1 > explore > local_events

v1 > explore > reels

v1 > files > avatars > create

Request Body

v1 > files > post-pictures > create

Request Body

v1 > files > post-pictures > delete

Path Parameters

v1 > files > reel > upload-url > list

v1 > guest > explore > list

Query Parameters

v1 > guest > explore > events

v1 > guest > explore > reels

v1 > guest > explore > read

Path Parameters

v1 > guest > explore > comments > list

Path Parameters

Query Parameters

v1 > invitation > email > create

v1 > local-life > post > list

Query Parameters

v1 > local-life > post > read

Path Parameters

Query Parameters

v1 > locations > countries > list

v1 > messenger > list

Query Parameters

v1 > messenger > create

Request Body

v1 > messenger > share

Request Body

v1 > messenger > read

Path Parameters

v1 > messenger > delete

Path Parameters

v1 > messenger > validate_access