get
https://partner.gupshup.io/partner//app-link/details
Paginated, filtered listing of app-link requests for a partner.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Paginated, filtered listing of app-link requests scoped to {partnerId}.
API Requests:
curl --location --request GET 'https://partner.gupshup.io/partner/{{PARTNER_ID}}/app-link/details?status=PENDING&pageNo=1&pageSize=10' \
--header 'token: {{PARTNER_TOKEN}}'Response:
| Status Code | Response | Comments |
|---|---|---|
| 200 | { "items": [ { "id": "b3f1e2a0-6c4d-4e8a-9c1a-2f6d8e0a1b2c", "appId": "app_xyz123", "appName": "My App", "customerId": "cust_1", "customerIdentifier": "[email protected]", "partnerId": 8814, "status": "PENDING", "requestedAt": 1783053048000, "expiresAt": 1785645048000, "decidedAt": null, "decidedByEmail": null } ], "pageNo": 1, "pageSize": 10, "totalCount": 1 } | Success. Each item carries full detail — no separate get-by-id endpoint. |
| 200 | { "items": [], "pageNo": 1, "pageSize": 10, "totalCount": 0 } | Success with no matching rows. |
| 401 | { "status": "error", "message": "Unauthorised access to the resource. Please review request parameters and headers and retry" } | Missing/invalid authentication. |
| 403 | { "status": "error", "message": "Forbidden Access" } | Path partnerId mismatch or not PARTNER_ADMIN. |
| 429 | { "status": "error", "message": "Too Many Requests" } | More than 30 requests / 60 seconds. |
| 500 | { "status": "error", "message": "Internal server error. Please try again later and If Issue still persist then contact Gupshup Dev Support" } | Unexpected server failure. |
Request Parameters:
| Key | Description | Values | Data Type | Required / Optional | Constraints |
|---|---|---|---|---|---|
| token | Partner token credential | {{PARTNER_TOKEN}} | String | Required | See §1. |
| partnerId | Partner ID (path) | e.g. 8814 | Integer | Required | Must match authenticated partner context. |
| status | Status filter | PENDING, APPROVED, REJECTED, EXPIRED | String | Optional | Exact match (case-insensitive). Unrecognized values are ignored (same as no filter). |
| appId | App ID filter | e.g. app_xyz123 | String | Optional | Exact match; blank/null = no filter. |
| appName | App name filter | substring | String | Optional | Repository search filter; blank = no filter. |
| customerId | Customer ID filter | e.g. cust_1 | String | Optional | Exact match; blank = no filter. |
| pageNo | Page number | 1 | Integer | Optional (default 1) | 1-indexed. Values < 1 are treated as page 0 internally. |
| pageSize | Page size | 10 | Integer | Optional (default 10) | Items per page. |
| Key | Description | Values | Data Type | Required / Optional | Constraints |
| token | Partner token credential | {{PARTNER_TOKEN}} | String | Required | See §1. |
| partnerId | Partner ID (path) | e.g. 8814 | Integer | Required | Must match authenticated partner context. |
| status | Status filter | PENDING, APPROVED, REJECTED, EXPIRED | String | Optional | Exact match (case-insensitive). Unrecognized values are ignored (same as no filter). |