Bulk Delete Subscriber First Activation Time
This API is used to reset the date and time value of the first activation SIM registration to the floLIVE core network for multiple SIM cards in a single call.
|
HTTP URL |
|
|---|---|
| POST | /api/v2/bulk/subscriber/reset-activation-time |
Eligibility
The Requestor is eligible to request SIM first activation time deletion for his own subscribers or one of his sub-customers’ subscribers.
API Request
Request Structure
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
bulk |
Object |
M |
Array of main request body object. |
bulk object
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
subscriberIdentifiers |
Object |
M |
Subscriber unique keys object, defines the search criteria. |
|
content |
Object |
M |
Main elements container object |
subscriberIdentifiers object
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
type |
String |
M |
Defines the search criteria. Valid type ENUMs are: ‘IMSI’, ‘ICCID’, ‘MSISDN’, ‘IMEI’, ‘IMEISV’. |
|
value |
String |
M |
Type value. IMSI or ICCID or MSISDN or IMEI or IMEISV number. |
content object
N/A
API Response
Response Structure
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
bulk |
Object |
M |
Array of main response body object. |
|
pageable |
Object |
O |
Paging information object displayed when an API call was successful. For a failure, it will be empty. |
bulk object
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
errorCode |
String |
O |
Failure code. See list below, under ‘Error Codes’ section. |
|
errorMessage |
String |
O |
Failure detailed description. See list below, under ‘Error Codes’ section. |
|
requestId |
UUID |
CM |
Request instance ID. To be used by external systems to query the call (operation) status, whether in progress, successful or failed. Displayed when an API call was successful. For a failure, it will be empty. |
|
subscriberIdentifiers |
Object |
M |
Subscriber unique keys object, defines the search criteria. |
|
content |
Object |
M |
Main response body object. Reflects a single node of the original request. |
subscriberIdentifiers object
|
Parameter |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
type |
String |
M |
Defines the search criteria. Valid type ENUMs are: ‘IMSI’, ‘ICCID’, ‘MSISDN’, ‘IMEI’, ‘IMEISV’. |
|
value |
String |
M |
Type value. IMSI or ICCID or MSISDN or IMEI or IMEISV number. |
content object
N/A
Pageable data objects
|
Element |
Type |
M/O/CM |
Description |
|---|---|---|---|
|
page |
Numeric |
M |
Page number |
|
size |
Numeric |
M |
Page size. Number of requested elements per page |
|
totalPages |
Numeric |
M |
Total amount of available pages per requested page size |
|
totalElements |
Numeric |
M |
Total amount of retrieved elements |
Error Codes
In addition to the general success and failure codes, the following error codes are possible.
|
Code |
Message |
|---|---|
|
GLOBAL_1001 |
Service unavailable. Please try again |
|
SUBSCRIBER_1063 |
Failed to reset SIM first activation time |
Examples
Request Body
{
"bulk": [
{
"subscriberIdentifiers": {
"type": "IMSI",
"value": "222013090963830"
},
"content": {}
},
{
"subscriberIdentifiers": {
"type": "IMSI",
"value": "222013090961866"
},
"content": {}
}
]
}Response Body: Full Success ACK
{
"bulk": [
{
"errorCode": "",
"errorMessage": "",
"requestId": "ff74dca6-8e7f-4b85-a42b-13860913b370",
"subscriberIdentifiers": {
"type": "IMSI",
"value": "222013090963830"
},
"content": {}
},
{
"errorCode": "",
"errorMessage": "",
"requestId": "7e74dce6-8eef-4c86-a4bb-1a860913c271",
"subscriberIdentifiers": {
"type": "IMSI",
"value": "222013090961866"
},
"content": {}
}
],
"pageable": {
"page": 0,
"size": 10,
"totalPages": 1,
"totalElements": 1
}
}Response Body: Includes Failure/s NAK
{
"bulk": [
{
"errorCode": "SUBSCRIBER_1000",
"errorMessage": "Validation failed",
"requestId": "",
"subscriberIdentifiers": {
"type": "IMSI",
"value": "222013090963830"
},
"content": {}
}
],
"pageable": {
"page": 0,
"size": 10,
"totalPages": 1,
"totalElements": 1
}
}