This document is generated by Aladia.

List All Profile Viewers

Developing

GET

/notifications/profile-viewers

This endpoint retrieves a list of all users who have viewed the current user's profile. The response includes standard notification details along with an isOnline field indicating whether the viewer is currently online. The online status is determined by retrieving the profile of each user.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.aladia.io/v2/notifications/profile-viewers?limit=50&next=&prev=' \
--header 'apikey: '

Response Example

{
    "data": [
        {
            "id": "66d9b0c5a469129b9e4425c8",
            "type": "profile",
            "fullName": "Daniel Tesema",
            "image": null,
            "isFollowing": false,
            "mutualFollow": null,
            "isOnline": true,
            "createdAt": "2024-10-07T10:18:03.308Z"
        },
        {
            "id": "66d9b08aa469129b9e44257a",
            "type": "profile",
            "fullName": "Daniel Tilahun",
            "image": null,
            "isFollowing": true,
            "mutualFollow": null,
            "isOnline": false,
            "createdAt": "2024-10-07T10:18:03.308Z"
        },
        {
            "id": "66d9b0c5a469129b9e4425c8",
            "type": "profile",
            "fullName": "Daniel Tesema",
            "image": null,
            "isFollowing": false,
            "mutualFollow": null,
            "isOnline": true,
            "createdAt": "2024-10-07T10:18:03.308Z"
        },
        {
            "id": "66d9b08aa469129b9e44257a",
            "type": "profile",
            "fullName": "Daniel Tilahun",
            "image": null,
            "isFollowing": true,
            "mutualFollow": null,
            "isOnline": false,
            "createdAt": "2024-10-07T10:18:03.308Z"
        }
    ],
    "cursor": {
        "next": "2024-09-05T13:34:32.379Z",
        "prev": null,
        "totalItems": 8
    }
}

Request

Query Params

limit

integer

optional

Number of documents per page in the response

Default:

string

optional

Next token cursor, to navigate towards the next page

string

optional

Previous token cursor, to navigate towards the previous page

Header Params

apikey

string

optional

Example:

Responses

🟢200Success

application/json

Body

data

array [object {8}]

required

string

required

id of the user

type

enum<string>

required

either profile or organization

Allowed values:

profileorganization

fullName

string

required

fullName of the user

image

string | null

optional

image of the user

isFollowing

boolean | null

required

check if the user still follows (latest value of mutualFollow)

mutualFollow

boolean | null

required

This field is used in follow notifications to specify if the follow is mutual. "true if follow eachother"

createdAt

string

required

A string representing the timestamp when the sender entity was created.

isOnline

boolean

required

Indicates if the viewer is currently online

cursor

object (Cursor)

required

totalItems

integer

required

Number of total items

string | null

required

Previous token cursor, to navigate towards the previous page

string | null

required

Next token cursor, to navigate towards the next page

Modified at 2025-04-12 09:42:02

Retrieve Grouped Senders

Create Many Signed Upload Urls