User Issues
List and view details of issues filed by the authenticated user.
List User Issues
GET/ret11/user-issues
Auth Required
Include a Bearer token.
Parameters
| Parameter | In | Required | Description |
|---|---|---|---|
| page | query | optional | Page number. Default: 1 |
| limit | query | optional | Items per page. Default: 10 |
| issueStatus | query | optional | Filter by status: "OPEN" | "RESOLVED" | "CLOSED" |
| userId | query | optional | Required only for service-account tokens |
Response
| Field | Type | Description |
|---|---|---|
| data.issues[] | array | List of issue summaries |
| data.total | number | Total issue count for pagination |
| issues[].id | string | Issue identifier |
| issues[].transactionId | string | ONDC transaction ID linked to this issue |
| issues[].level | string | Issue escalation level. E.g., "ISSUE" |
| issues[].status | string | Current issue status: "OPEN" | "RESOLVED" | "CLOSED" |
| issues[].subCategory | string | Sub-category code. E.g., "ORD101" |
| issues[].category | string | Issue category. E.g., "ORDER" |
| issues[].shortDesc | string | Short issue description |
| issues[].longDesc | string | Full issue description |
| issues[].customerName | string | Name of the customer who filed the issue |
| issues[].orderId | string | Linked order ID |
| issues[].createdAt | string | ISO 8601 creation timestamp |
| issues[].updatedAt | string | ISO 8601 last-updated timestamp |
Response Example
{
"data": {
"issues": [
{
"id": "019c3f2a-1234-7abc-8def-0123456789ab",
"transactionId": "56a55c3f-8052-4bb6-91d6-47e1a178a0c0",
"level": "ISSUE",
"status": "OPEN",
"subCategory": "ORD101",
"category": "ORDER",
"shortDesc": "Order not received",
"longDesc": "I placed an order but it was never delivered.",
"customerName": "John Doe",
"orderId": "019d1476113e75598fa4d0389075cef0",
"createdAt": "2026-06-10T09:00:00.000Z",
"updatedAt": "2026-06-10T09:00:00.000Z"
}
],
"total": 42
}
}Escalating an Issue
If a resolution is not satisfactory, use reply-issue with descriptorCode: "ESCALATE" to escalate to the next level.