post https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/devices/usage-controls/searches
The Device Usage Control Inquiry API enables the cardholder to get the current and future status of device (card) usage controls like international and domestic ATM, POS, E-commerce, contactless, MDES in-app or VTS in-app, MDES contactless or VTS contactless, and MDES token QR transactions activation and deactivation. This API returns the following activations or deactivations for the applicable transaction channel depending on the activation period.
- If the activationType is periodic or for a specific duration, then current activations or deactivations are returned for periodic and immediate activation.
- If the activationType parameter value is L (Lifelong), only the latest effective entry is returned. The Device Usage Control Inquiry API is applicable for prepaid, credit, and debit products. Either of device identifier, device number, packID or device number alias parameter is mandatory.
HTTP Status and Response Status Matrix
- HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
- Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
- Reason: This is the description of the error code returned by Credit+ Issuing application.
| HTTP Code | Error Code | Reason |
|---|---|---|
| 200 | OK | The server successfully processed the request. |
| 400 | MISSING_REQUIRED_FIELD | Error example: Missing Required Field 'productType'. |
| 400 | INVALID_FIELD_VALUE | 'productType' field value 'pre-paid' is invalid. |
| 400 | RECORD_NOT_FOUND | Device record not found based on the given input. |
| 400 | UNIQUE_RECORD_NOT_FOUND | Multiple records found for given search criteria. |
| 403 | PERMISSION_DENIED | It seems you don't have permission to access this API. |