Skip to main content

Data Request Status API

Updated over 2 weeks ago

The Data Request Status API returns the status and data from a previously submitted Delete or Export request.

The responses vary based on which request you sent and your integration type. You will need the request_id from the Delete or Export API response to include in your request.

Endpoint

Before you attempt to connect, complete the steps in Prepare to Connect to Besitos APIs.

Endpoint URL

https://wall.besitos.ai/data/partner/gdpr/{partner_ID}/{request_id}

HTTP method

GET

Path parameter

Path parameter

Data type

Required

Description

partner_id

string

yes

Your Besitos partner ID.

request_id

string

yes

The request_id returned in the Delete or Export request.

Examples

Request

GET https://wall.besitos.ai/data/partner/gdpr/CwI606dZ/f19cf1c4-cea2-4ca9-ab25-de2e45ab98b4

Response for Delete request

{
    "success": true,
    "request": {
        "id": "7b3f07fd-6343-4b88-bffb-051bc5652b73",
        "action": "delete",
        "status": "completed",
        "partner_id": "CwI606dZ",
        "partner_user_ids": [
            "sampleuser1",
            "sampleuser2"
        ],
        "format": "json",
        "requested_at": "2026-02-25T15:19:45.000000Z",
        "processed_at": "2026-02-25T15:20:18.000000Z",
        "completed_at": "2026-02-25T15:20:18.000000Z",
        "expires_at": null,
        "error_message": null,
        "progress": {
            "total": 2,
            "completed": 1,
            "failed": 1,
            "pending": 0,
            "percentage": 100
        }
    },
    "data": {
        "data": {
            "verification": {
                "deletion_completed": true,
                "total_processed": 1,
                "verification_note": "Data deletion completed and verified"
            },
            "summary": {
                "message": "Successfully processed 1 subscriber deletion requests from 2 partner user IDs. Note: 1 partner user IDs were not found.",
                "success": true,
                "subscriber_ids": [
                    "b-clkxsnseqacvefhfn8"
                ],
                "processed_count": 1,
                "found_partner_user_ids": [
                    "sampleuser1"
                ],
                "provided_partner_user_ids": [
                    "sampleuser1",
                    "sampleuser2"
                ],
                "not_found_partner_user_ids": [
                    "sampleuser2"
                ]
            }
        }
    }
}

Response for Export request

{
    "success": true,
    "request": {
        "id": "3f4f183b-c32e-4982-97b5-2c79ffe07402",
        "action": "export",
        "status": "completed",
        "partner_id": "CwI606dZ",
        "partner_user_ids": [
            "sampleuser1",
            "sampleuser2"
        ],
        "format": "json",
        "requested_at": "2026-02-25T15:22:42.000000Z",
        "processed_at": "2026-02-25T15:23:31.000000Z",
        "completed_at": "2026-02-25T15:23:31.000000Z",
        "expires_at": "2026-03-04T15:23:31.000000Z",
        "error_message": null,
        "progress": {
            "total": 2,
            "completed": 1,
            "failed": 1,
            "pending": 0,
            "percentage": 100
        }
    },
    "data": {
        "data": [
            {
                "status": true,
                "sub_id": null,
                "balance": "0.00",
                "last_name": null,
                "country_id": 1,
                "first_name": null,
                "partner_id": "CwI606dZ",
                "email_address": "[email protected]",
                "payout_records": [],
                "enrolled_offers": [],
                "partner_user_id": "sampleuser1",
                "redeem_requests": [],
                "activity_summary": {
                    "last_activity_timestamp": "2026-02-25 10:22:21"
                },
                "offer_participation": [],
                "device_platforms_used": [],
                "last_updated_timestamp": "2026-02-25T16:22:26.000000Z",
                "account_creation_timestamp": "2026-02-25T15:22:21.000000Z",
                "support_interactions_count": 0
            },
            null
        ]
    }
}

Response attributes

Delete User Data

Attributes

Data Type

Description

Example

success

boolean

The request status can be true (success) or false (failed).

true

Request

id

string

The unique request_id from the Delete request response.

"7b3f07fd-6343-4b88-bffb-051bc5652b73"

action

string

Identifies the request type.

"export"

status

string

Identifies the request status.

"completed"

partner_id

string

Your unique partner ID.

"CwI606dZ"

partner_user_ids

array

Contains the users' unique IDs.

"partner_user_ids": [ "sampleuser1", "sampleuser2" ]

format

string

Identifies the code language.

"json"

requested_at

datetime

The date and time in ET when the Delete request was made.

"2026-02-25T15:22:42.000000Z"

processed_at

datetime

The date and time in ET when the request was processed.

"2026-02-25T15:23:31.000000Z"

completed_at

datetime

The date and time in ET when the request was completed.

"2026-02-25T15:23:31.000000Z"

expires_at

datetime

The date and time in ET when the request will expire.

"2026-03-04T15:23:31.000000Z"

error_message

string

If an error occurred, the code and type are included. If no error occurred, the value is null.

null

Progress

total

integer

The number of user IDs included in the request.

2

completed

integer

The number of user IDs deleted.

1

failed

integer

The number of user IDs that failed to delete.

1

pending

integer

The number of user IDs within the request that are pending deletion.

0

percentage

integer

The percentage of the request that was processed.

100

Data

Verification

deletion_completed

boolean

The completion status can be true (complete) or false (incomplete).

true

total_processed

integer

The number of requests processed.

1

verification_note

string

A note verifying the request status.

"Data deletion completed and verified"

Summary

message

string

Explains the request status, including why the request failed, if applicable.

"Successfully processed 1 subscriber deletion requests from 2 partner user IDs. Note: 1 partner user IDs were not found."

success

boolean

The success of the request can be true (success) or false (failed).

true

subscriber_ids

string

The users' Besitos IDs.

"b-clkxsnseqacvefhfn8"

processed_count

integer

The number of completed "delete" processes.

1

found_partner_user_ids

string

The user IDs found in the database.

"sampleuser1"

provided_partner_user_ids

string

The user IDs included in the initial Delete request.

"sampleuser1", "sampleuser2"

not_found_partner_user_ids

string

The user IDs not found in the database.

"sampleuser2"

Export User Data

Some of the attributes defined below may not be included in your dataset because they are not supported by your integration type.

Attributes

Data Type

Description

Example

success

boolean

The request status can be true (success) or false (failed).

true

Request

id

string

The unique request_id from the Export request response.

"3f4f183b-c32e-4982-97b5-2c79ffe07402"

action

string

Identifies the request type.

"export"

status

string

Identifies the request status.

"completed"

partner_id

string

Your unique partner ID.

"CwI606dZ"

partner_user_ids

string

Contains the users' unique IDs.

"partner_user_ids": [ "sampleuser1", "sampleuser2" ]

format

array

Identifies the code language.

"json"

requested_at

datetime

The date and time in ET when the Delete request was made.

"2026-02-25T15:22:42.000000Z"

processed_at

datetime

The date and time in ET when the request was processed.

"2026-02-25T15:23:31.000000Z"

completed_at

datetime

The date and time in ET when the request was completed.

"2026-02-25T15:23:31.000000Z"

expires_at

datetime

The date and time in ET when the request will expire.

"2026-03-04T15:23:31.000000Z"

error_message

string

If an error occurred, the code and type are included. If no error occurred, the value is null.

null

Progress

total

integer

The number of user IDs included in the request.

2

completed

integer

The number of user IDs deleted.

1

failed

integer

The number of user IDs that failed to delete.

1

pending

integer

The number of user IDs within the request that are pending deletion.

0

percentage

integer

The percentage of the request that was processed.

100

Data

status

boolean

The user's activity status can be true (active) or false (inactive).

true

sub_id

string

The sub ID the user belongs to.

"558b904"

balance

numeric

The user's account balance.

"5.50"

last_name

string

The user's last name as entered at sign-up.

"User"

country_code

string

The user's ISO 3166-1 alpha-2 country code.

US

first_name

string

The user's first name as entered at sign-up.

"Test"

partner_id

string

Your Besitos partner ID.

"CwI606dZ"

email_address

string

The user's email address as entered at sign-up.

"[email protected]"

payout_records

string

The user's payout records, including the amount and the timestamp in ET.

"[{\"amount\":10,\"status\":5,\"processed_at\":\"2024-11-08T16:44:48.000000Z\"},{\"amount\":10,\"status\":5,\"processed_at\":\"2024-11-08T16:57:43.000000Z\"},{\"amount\":10,\"status\":3,\"processed_at\":\"2024-12-10T10:07:46.000000Z\"}]"

enrolled_offers

string

The offer ID, name, and enrollment timestamp in ET for offers the user is currently enrolled in.

"[{\"offer_id\":\"UnjTSQWE5z6x\",\"offer_name\":\"3 Tiles: Tile Matching Games - Android\",\"enrolled_at\":\"2026-02-06 02:33:29\"}]"

partner_user_id

string

The user's ID in your system.

"T7D8uz2Bo5kbdhqWfkjvbfv"

redeem_requests

string

A record of the user's withdrawal requests, including amount and timestamp in ET.

"[{\"amount\":\"10.00\",\"requested_at\":\"2024-11-08T16:57:30.000000Z\"},{\"amount\":\"10.00\",\"requested_at\":\"2024-12-10T14:14:25.000000Z\"},{\"amount\":\"10.00\",\"requested_at\":\"2024-12-10T14:28:41.000000Z\"}]"

Activity Summary

last_activity_timestamp

datetime

The user's most recent activity with an offer in ET.

"2026-02-25 10:22:21"

offer_participation

string

The offer ID, name, and most recent participation timestamp in ET for the offers the user has participated in.

[{\"offer_id\":\"UnjTSQWE5z6x\",\"offer_name\":\"3 Tiles: Tile Matching Games - Android\",\"participated_at\":\"2025-09-30 12:52:10\"}]

device_platforms_used

string

The user's device platform: android or ios.

android

last_updated_timestamp

datetime

The time in ET when the user's records were last updated.

"2026-02-25T16:22:26.000000Z"

account_creation_timestamp

datetime

The time in ET when the user created their account.

This is included only if your integration type supports it.

"2026-02-25T15:22:21.000000Z"

support_interactions_count

integer

The number of times the user has requested help from Besitos Support.

2

Related Articles
Conversion Data API
Messenger API
Deals User Data API
Delete User Data API
Export User Data API
Did this answer your question?