Reports API
Report abuse, block users, view your reports, and admin endpoints for managing reports and taking moderation actions.
The Reports API allows users to report abusive content or behavior, block other users, and enables admins to review and act on reports.
Submit Report
POST /api/v1/reports — Required
List My Reports
GET /api/v1/reports/my — Required
Block User
POST /api/v1/users/block/:userId — Required
Unblock User
DELETE /api/v1/users/block/:userId — Required
List Blocked Users
GET /api/v1/users/blocked — Required
All Reports (Admin)
GET /api/v1/admin/reports — Admin
Update Report (Admin)
PATCH /api/v1/admin/reports/:id — Admin
Take Action (Admin)
POST /api/v1/admin/reports/:id/action — Admin
Submit a Report
Report abusive content or behavior.
POST /api/v1/reports — Auth: Required
Request body
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Report type: SPAM, HARASSMENT, INAPPROPRIATE, SCAM, OTHER |
description | string | Yes | Detailed description of the issue |
targetUserId | string | No | ID of the user being reported |
tagId | string | No | ID of the tag being reported |
messageId | string | No | ID of the message being reported |
curl -X POST https://api.qriotag.global/api/v1/reports \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"type": "SCAM",
"description": "This user sent me a message claiming to have found my item but is asking for payment upfront before returning it.",
"targetUserId": "usr_xyz789",
"messageId": "msg_001"
}'Response
{
"success": true,
"data": {
"id": "rpt_abc123",
"type": "SCAM",
"status": "OPEN",
"message": "Report submitted. Our team will review it within 24 hours."
}
}List My Reports
Retrieve all reports submitted by the authenticated user.
GET /api/v1/reports/my — Auth: Required
curl https://api.qriotag.global/api/v1/reports/my \
-H "Authorization: Bearer <token>"Response
{
"success": true,
"data": [
{
"id": "rpt_abc123",
"type": "SCAM",
"status": "REVIEWING",
"description": "This user sent me a message claiming...",
"createdAt": "2025-06-01T10:00:00.000Z"
}
]
}Block a User
Block a user from contacting you through QrioTag.
POST /api/v1/users/block/:userId — Auth: Required
curl -X POST https://api.qriotag.global/api/v1/users/block/usr_xyz789 \
-H "Authorization: Bearer <token>"Response
{
"success": true,
"data": {
"message": "User blocked"
}
}Unblock a User
Remove a user from your block list.
DELETE /api/v1/users/block/:userId — Auth: Required
curl -X DELETE https://api.qriotag.global/api/v1/users/block/usr_xyz789 \
-H "Authorization: Bearer <token>"Response
{
"success": true,
"data": {
"message": "User unblocked"
}
}List Blocked Users
Retrieve all users you have blocked.
GET /api/v1/users/blocked — Auth: Required
curl https://api.qriotag.global/api/v1/users/blocked \
-H "Authorization: Bearer <token>"Response
{
"success": true,
"data": [
{
"userId": "usr_xyz789",
"blockedAt": "2025-06-01T10:30:00.000Z"
}
]
}Admin Endpoints
Was this page helpful?