Fixed portabilities

Get minimum UTC portability windowDate

Get minimum portability windowDate in UTC format

GET /orgs/{orgId}/fixed/windowDate

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
processType	query	string	false	processType of the portability wanted to get the minimum windowDate. Default if missing is 15

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/windowDate?processType='15' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	minimumWindowDate
400	Bad Request	Invalid parameter supplied	None

200 - instance of minimumWindowDate

Custom schema example

1
2
3


{
  "result": "2024-05-20T22:00:00Z"
}

Name	Type	Required	Description
result	string	true	minimum window date

Get last portability by phonenumber

GET /orgs/{orgId}/fixed/portabilityByPhonenumber/{phonenumber}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
phonenumber	path	string	true	The cli phonenunber

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/portabilityByPhonenumber/{phonenumber} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	portabilityInfo
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62


{
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "stateId": 1,
  "messageType": "DSP1",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL",
  "recipientRol": true,
  "processId": "00031202005111500003",
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "requestDate": "2017-09-13T13:00:00",
  "messageDate": "2017-09-13T14:00:00",
  "windowDate": "2017-09-15T08:00:00",
  "cancellationDate": "2017-09-15T08:00:00",
  "processType": 15,
  "administrative": "445022444216",
  "lluProcessId": "550739346020000001",
  "fullNumberFlag": 0,
  "wholesalerFlag": 0,
  "accessType": "01",
  "donorResellerOperator": "REVENDEDOR",
  "recipientResellerOperator": "MASMOVIL",
  "subscriber": {
    "nif": "11111111H",
    "name": "nombre apellidos",
    "address": "Calle COLON",
    "postalCode": "28100",
    "province": "28",
    "town": "Madrid",
    "date": "2017-09-13T13:00:00"
  },
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
  "observations": "",
  "infoTariff": "",
  "internal": false,
  "isCancellable": false,
  "accessPhoneRanges": [
    {
      "accessType": "01",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "eventList": [
    {
      "eventTimestamp": "2017-09-15T08:42:33.123456",
      "messageType": "DSP1",
      "messageId": "00031202005110000003",
      "subProcessId": "00031202005110200003",
      "eventType": "EVENT",
      "causeCode": "0001",
      "administrative": "445022444216"
    }
  ]
}

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get portabilities by phonenumber

GET /orgs/{orgId}/fixed/portabilitiesByPhonenumber/{phonenumber}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
phonenumber	path	string	true	The cli phonenunber
filters	query	string	false	Typical filters: donorOperator, recipientRol, messageType, processType, …

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/portabilitiesByPhonenumber/{phonenumber}?filters='donorOperator='00031'ANDrecipientRol=falseANDmessageTypeIN('DSP1','DSP2')' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	[portabilityInfo]
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64


[
  {
    "phoneRanges": [
      {
        "nrnRange": "312800",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "stateId": 1,
    "messageType": "DSP1",
    "externalReference": "MYSIM_112233",
    "brand": "MASMOVIL",
    "recipientRol": true,
    "processId": "00031202005111500003",
    "recipientOperator": "00031",
    "donorOperator": "00001",
    "requestDate": "2017-09-13T13:00:00",
    "messageDate": "2017-09-13T14:00:00",
    "windowDate": "2017-09-15T08:00:00",
    "cancellationDate": "2017-09-15T08:00:00",
    "processType": 15,
    "administrative": "445022444216",
    "lluProcessId": "550739346020000001",
    "fullNumberFlag": 0,
    "wholesalerFlag": 0,
    "accessType": "01",
    "donorResellerOperator": "REVENDEDOR",
    "recipientResellerOperator": "MASMOVIL",
    "subscriber": {
      "nif": "11111111H",
      "name": "nombre apellidos",
      "address": "Calle COLON",
      "postalCode": "28100",
      "province": "28",
      "town": "Madrid",
      "date": "2017-09-13T13:00:00"
    },
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
    "observations": "",
    "infoTariff": "",
    "internal": false,
    "isCancellable": false,
    "accessPhoneRanges": [
      {
        "accessType": "01",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "eventList": [
      {
        "eventTimestamp": "2017-09-15T08:42:33.123456",
        "messageType": "DSP1",
        "messageId": "00031202005110000003",
        "subProcessId": "00031202005110200003",
        "eventType": "EVENT",
        "causeCode": "0001",
        "administrative": "445022444216"
      }
    ]
  }
]

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get portabilities by external reference

GET /orgs/{orgId}/fixed/portabilitiesByExternalReference/{externalReference}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
externalReference	path	string	true	The external reference
filters	query	string	false	Typical filters: externalReference, recipientRol, messageType, processType, …

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/portabilitiesByExternalReference/{externalReference}?filters='donorOperator='00031'ANDrecipientRol=falseANDmessageTypeIN('DSP1','DSP2')' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	[portabilityInfo]
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64


[
  {
    "phoneRanges": [
      {
        "nrnRange": "312800",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "stateId": 1,
    "messageType": "DSP1",
    "externalReference": "MYSIM_112233",
    "brand": "MASMOVIL",
    "recipientRol": true,
    "processId": "00031202005111500003",
    "recipientOperator": "00031",
    "donorOperator": "00001",
    "requestDate": "2017-09-13T13:00:00",
    "messageDate": "2017-09-13T14:00:00",
    "windowDate": "2017-09-15T08:00:00",
    "cancellationDate": "2017-09-15T08:00:00",
    "processType": 15,
    "administrative": "445022444216",
    "lluProcessId": "550739346020000001",
    "fullNumberFlag": 0,
    "wholesalerFlag": 0,
    "accessType": "01",
    "donorResellerOperator": "REVENDEDOR",
    "recipientResellerOperator": "MASMOVIL",
    "subscriber": {
      "nif": "11111111H",
      "name": "nombre apellidos",
      "address": "Calle COLON",
      "postalCode": "28100",
      "province": "28",
      "town": "Madrid",
      "date": "2017-09-13T13:00:00"
    },
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
    "observations": "",
    "infoTariff": "",
    "internal": false,
    "isCancellable": false,
    "accessPhoneRanges": [
      {
        "accessType": "01",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "eventList": [
      {
        "eventTimestamp": "2017-09-15T08:42:33.123456",
        "messageType": "DSP1",
        "messageId": "00031202005110000003",
        "subProcessId": "00031202005110200003",
        "eventType": "EVENT",
        "causeCode": "0001",
        "administrative": "445022444216"
      }
    ]
  }
]

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get portability by processId

GET /orgs/{orgId}/fixed/portabilitiesByProcessId/{processId}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
processId	path	string	true	The Portanet identificator
filters	query	string	false	Typical filters: externalReference, recipientRol, messageType, processType, …

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/portabilitiesByProcessId/{processId}?filters='donorOperator='00031'ANDrecipientRol=falseANDmessageTypeIN('DSP1','DSP2')' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	[portabilityInfo]
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64


[
  {
    "phoneRanges": [
      {
        "nrnRange": "312800",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "stateId": 1,
    "messageType": "DSP1",
    "externalReference": "MYSIM_112233",
    "brand": "MASMOVIL",
    "recipientRol": true,
    "processId": "00031202005111500003",
    "recipientOperator": "00031",
    "donorOperator": "00001",
    "requestDate": "2017-09-13T13:00:00",
    "messageDate": "2017-09-13T14:00:00",
    "windowDate": "2017-09-15T08:00:00",
    "cancellationDate": "2017-09-15T08:00:00",
    "processType": 15,
    "administrative": "445022444216",
    "lluProcessId": "550739346020000001",
    "fullNumberFlag": 0,
    "wholesalerFlag": 0,
    "accessType": "01",
    "donorResellerOperator": "REVENDEDOR",
    "recipientResellerOperator": "MASMOVIL",
    "subscriber": {
      "nif": "11111111H",
      "name": "nombre apellidos",
      "address": "Calle COLON",
      "postalCode": "28100",
      "province": "28",
      "town": "Madrid",
      "date": "2017-09-13T13:00:00"
    },
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
    "observations": "",
    "infoTariff": "",
    "internal": false,
    "isCancellable": false,
    "accessPhoneRanges": [
      {
        "accessType": "01",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "eventList": [
      {
        "eventTimestamp": "2017-09-15T08:42:33.123456",
        "messageType": "DSP1",
        "messageId": "00031202005110000003",
        "subProcessId": "00031202005110200003",
        "eventType": "EVENT",
        "causeCode": "0001",
        "administrative": "445022444216"
      }
    ]
  }
]

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get all portabilities for a date

GET /orgs/{orgId}/fixed/portabilitiesByDate/{dateField}/{dateValue}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
dateField	path	string	true	The date field to filter: requestDate, messageDate, windowDate or cancellationDate
dateValue	path	string(date)	true	The value date
filters	query	string	false	Typical filters: externalReference, recipientRol, messageType, processType, …

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/portabilitiesByDate/{dateField}/{dateValue}?filters='donorOperator='00031'ANDrecipientRol=falseANDmessageTypeIN('DSP1','DSP2')' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	[portabilityInfo]
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64


[
  {
    "phoneRanges": [
      {
        "nrnRange": "312800",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "stateId": 1,
    "messageType": "DSP1",
    "externalReference": "MYSIM_112233",
    "brand": "MASMOVIL",
    "recipientRol": true,
    "processId": "00031202005111500003",
    "recipientOperator": "00031",
    "donorOperator": "00001",
    "requestDate": "2017-09-13T13:00:00",
    "messageDate": "2017-09-13T14:00:00",
    "windowDate": "2017-09-15T08:00:00",
    "cancellationDate": "2017-09-15T08:00:00",
    "processType": 15,
    "administrative": "445022444216",
    "lluProcessId": "550739346020000001",
    "fullNumberFlag": 0,
    "wholesalerFlag": 0,
    "accessType": "01",
    "donorResellerOperator": "REVENDEDOR",
    "recipientResellerOperator": "MASMOVIL",
    "subscriber": {
      "nif": "11111111H",
      "name": "nombre apellidos",
      "address": "Calle COLON",
      "postalCode": "28100",
      "province": "28",
      "town": "Madrid",
      "date": "2017-09-13T13:00:00"
    },
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
    "observations": "",
    "infoTariff": "",
    "internal": false,
    "isCancellable": false,
    "accessPhoneRanges": [
      {
        "accessType": "01",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "eventList": [
      {
        "eventTimestamp": "2017-09-15T08:42:33.123456",
        "messageType": "DSP1",
        "messageId": "00031202005110000003",
        "subProcessId": "00031202005110200003",
        "eventType": "EVENT",
        "causeCode": "0001",
        "administrative": "445022444216"
      }
    ]
  }
]

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get last recipient portability by phonenumber

GET /orgs/{orgId}/fixed/recipient/portabilityByPhonenumber/{phonenumber}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
phonenumber	path	string	true	The cli phonenunber

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/recipient/portabilityByPhonenumber/{phonenumber} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	portabilityInfo
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62


{
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "stateId": 1,
  "messageType": "DSP1",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL",
  "recipientRol": true,
  "processId": "00031202005111500003",
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "requestDate": "2017-09-13T13:00:00",
  "messageDate": "2017-09-13T14:00:00",
  "windowDate": "2017-09-15T08:00:00",
  "cancellationDate": "2017-09-15T08:00:00",
  "processType": 15,
  "administrative": "445022444216",
  "lluProcessId": "550739346020000001",
  "fullNumberFlag": 0,
  "wholesalerFlag": 0,
  "accessType": "01",
  "donorResellerOperator": "REVENDEDOR",
  "recipientResellerOperator": "MASMOVIL",
  "subscriber": {
    "nif": "11111111H",
    "name": "nombre apellidos",
    "address": "Calle COLON",
    "postalCode": "28100",
    "province": "28",
    "town": "Madrid",
    "date": "2017-09-13T13:00:00"
  },
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
  "observations": "",
  "infoTariff": "",
  "internal": false,
  "isCancellable": false,
  "accessPhoneRanges": [
    {
      "accessType": "01",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "eventList": [
    {
      "eventTimestamp": "2017-09-15T08:42:33.123456",
      "messageType": "DSP1",
      "messageId": "00031202005110000003",
      "subProcessId": "00031202005110200003",
      "eventType": "EVENT",
      "causeCode": "0001",
      "administrative": "445022444216"
    }
  ]
}

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get last donor portability by phonenumber

GET /orgs/{orgId}/fixed/donor/portabilityByPhonenumber/{phonenumber}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
phonenumber	path	string	true	The cli phonenunber

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/donor/portabilityByPhonenumber/{phonenumber} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful operation	portabilityInfo
400	Bad Request	Invalid parameters supplied	None
404	Not Found	Portability not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of portabilityInfo

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62


{
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "stateId": 1,
  "messageType": "DSP1",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL",
  "recipientRol": true,
  "processId": "00031202005111500003",
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "requestDate": "2017-09-13T13:00:00",
  "messageDate": "2017-09-13T14:00:00",
  "windowDate": "2017-09-15T08:00:00",
  "cancellationDate": "2017-09-15T08:00:00",
  "processType": 15,
  "administrative": "445022444216",
  "lluProcessId": "550739346020000001",
  "fullNumberFlag": 0,
  "wholesalerFlag": 0,
  "accessType": "01",
  "donorResellerOperator": "REVENDEDOR",
  "recipientResellerOperator": "MASMOVIL",
  "subscriber": {
    "nif": "11111111H",
    "name": "nombre apellidos",
    "address": "Calle COLON",
    "postalCode": "28100",
    "province": "28",
    "town": "Madrid",
    "date": "2017-09-13T13:00:00"
  },
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
  "observations": "",
  "infoTariff": "",
  "internal": false,
  "isCancellable": false,
  "accessPhoneRanges": [
    {
      "accessType": "01",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "eventList": [
    {
      "eventTimestamp": "2017-09-15T08:42:33.123456",
      "messageType": "DSP1",
      "messageId": "00031202005110000003",
      "subProcessId": "00031202005110200003",
      "eventType": "EVENT",
      "causeCode": "0001",
      "administrative": "445022444216"
    }
  ]
}

Name	Type	Required	Description
phoneRanges	phoneRanges	false	none
stateId	stateId	false	portability state
messageType	messageType	false	Message type Portabaility
externalReference	externalReference	false	externalReference associated
brand	brand	false	brand associated
recipientRol	recipientRol	true	operator rol recipient or donor
processId	processId	true	process id in Portanet
recipientOperator	recipientOperator	false	current recipient operator code
donorOperator	donorOperator	false	initial donor operator code
requestDate	requestDate	false	request date for portability
messageDate	messageDate	false	date to send to Portanet
windowDate	windowDate	false	portability window
cancellationDate	cancellationDate	false	cancellation date
processType	processType	false	process type
administrative	administrative	false	administrative access number
lluProcessId	lluProcessId	false	local loop unbundling identifier
fullNumberFlag	fullNumberFlag	false	full number flag
wholesalerFlag	wholesalerFlag	false	wholesaler flag
accessType	accessType	false	portability access type
donorResellerOperator	donorResellerOperator	false	donor reseller operator
recipientResellerOperator	recipientResellerOperator	false	recipient reseller operator
subscriber	subscriber	false	none
causeCode	causeCode	false	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation
observations	observations	false	observations of a portability
infoTariff	infoTariff	false	info tariff of a portability
internal	internal	false	is a portability between own operators
isCancellable	isCancellable	false	is a portability cancellable
accessPhoneRanges	accessPhoneRanges	false	none
eventList	[event]	false	none

Get cause by cause code

get cause by cause code

GET /orgs/{orgId}/fixed/causesByCode/{causeCode}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
causeCode	path	string	true	Cause code

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/causesByCode/{causeCode} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful cause	[cause]
404	Not Found	Cause not found	None
405	Method Not Allowed	Validation exception	None

200 - instance of cause

Custom schema example

1
2
3
4
5
6
7


[
  {
    "messageType": "DSP1",
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor"
  }
]

Name	Type	Required	Description
messageType	messageTypeMandatory	true	Message type Portabaility
causeCode	causeCodeMandatory	true	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation

Get causes by message type

get causes by message type

GET /orgs/{orgId}/fixed/causesByMessageType/{messageType}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
messageType	path	string	true	Message type

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/causesByMessageType/{messageType} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful causes	[cause]
404	Not Found	Causes not found for message type	None
405	Method Not Allowed	Validation exception	None

200 - instance of cause

Custom schema example

1
2
3
4
5
6
7


[
  {
    "messageType": "DSP1",
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor"
  }
]

Name	Type	Required	Description
messageType	messageTypeMandatory	true	Message type Portabaility
causeCode	causeCodeMandatory	true	cause code of a denied operation
causeDescription	causeDescription	false	cause description of a denied operation

Get holiday calendar by year

get all holidays for a given year

GET /orgs/{orgId}/fixed/holidayCalendar/{year}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
year	path	string	true	the year to get the holidays calendar

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/holidayCalendar/{year} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful call	[date]
400	Bad Request	validation exception	None

200 - instance of date

Custom schema example

1
2
3


[
  "2024-12-25"
]

Name	Type	Required	Description
anonymous	string(date)	false	date

Get is holiday date

get is holiday day

GET /orgs/{orgId}/fixed/isHoliday/{dateValue}

Parameters

Name	In	Type	Required	Description
orgId	path	string	true	‘none’
dateValue	path	string(date)	true	The value date

Request example

1
2
3
4



curl -X GET https://mas-portability.sta.masstack.com/v3/orgs/{orgId}/fixed/isHoliday/{dateValue} \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	successful call	holiday
400	Bad Request	Validation exception	None

200 - instance of holiday

Custom schema example

1
2
3


{
  "isHoliday": true
}

Name	Type	Required	Description
isHoliday	boolean	true	return is holiday