masstack

V1
V2
V3
API Overview Resources Schemas

Mobile operations

Manage portabilities

Parameters

Name In Type Required Description
orgs path string true Tenant
body body PortabilityRequest true ‘none’

Request body - JsonObject

 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

{
  "access_type": "INDIVIDUAL",
  "contract_code": "00528902840",
  "external_reference": "PORTIN_902840_634443633",
  "msisdn_ranges": [
    {
      "initial_range": {
        "msisdn": {
          "country_code": "34",
          "number": "634443633"
        },
        "icc_id": "8934221507160508791"
      },
      "end_range": {
        "msisdn": {
          "country_code": "34",
          "number": "634443633"
        },
        "icc_id": "8934221507160508791"
      }
    }
  ],
  "nrn_receptor": "741111",
  "recipient_operator": null,
  "subscriber": {
    "addresses": [
      {
        "address": "Calle Leonardo Prieto, 8",
        "city": "Madrid",
        "country": "Spain",
        "postal_code": "28040",
        "province": "Madrid",
        "type": "CONTACT"
      }
    ],
    "document": "09288205T",
    "document_type": "NIF",
    "id": null,
    "email": null,
    "msisdn": {
      "country_code": "34",
      "number": "634443633"
    },
    "name": "Martina",
    "nationality": "España",
    "second_name": null,
    "surname": "Fraile Méndez"
  },
  "subscriber_request_date": "2022-02-24T13:45:10Z",
  "window_date": null
}
Name Type Required Description
access_type string true Access type of the request. Must be one of these values: [INDIVIDUAL,MULTIPLE,MIXED]
contract_code string true Contract signed by subscriber
external_reference string false External identifier
msisdn_ranges [MsisdnRanges] true List of phone number ranges to port
nrn_receptor string true Network Routing Number of recipient operator. Must match pattern ‘^[\d]{6,6}$’
recipient_operator string false Receiving operator code. Must match pattern ‘^[\d]{3,3}$’
subscriber Subscriber false none
subscriber_request_date string false Date of the portability request. Timestamp in UTC time zone, format yyyy-MM-ddTHH:mm:ssZ
window_date string false Window date of the portability. Timestamp in UTC time zone, format yyyy-MM-ddTHH:mm:ssZ
Property Values
access_type one of [INDIVIDUAL, MULTIPLE, MIXED]

Request 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


curl -X POST https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/portabilities \
  -H "Content-Type: application/json" \
 --data-raw "{
  'access_type': 'INDIVIDUAL',
  'contract_code': '00528902840',
  'external_reference': 'PORTIN_902840_634443633',
  'msisdn_ranges': [
    {
      'initial_range': {
        'msisdn': {
          'country_code': '34',
          'number': '634443633'
        },
        'icc_id': '8934221507160508791'
      },
      'end_range': {
        'msisdn': {
          'country_code': '34',
          'number': '634443633'
        },
        'icc_id': '8934221507160508791'
      }
    }
  ],
  'nrn_receptor': '741111',
  'recipient_operator': null,
  'subscriber': {
    'addresses': [
      {
        'address': 'Calle Leonardo Prieto, 8',
        'city': 'Madrid',
        'country': 'Spain',
        'postal_code': '28040',
        'province': 'Madrid',
        'type': 'CONTACT'
      }
    ],
    'document': '09288205T',
    'document_type': 'NIF',
    'id': null,
    'email': null,
    'msisdn': {
      'country_code': '34',
      'number': '634443633'
    },
    'name': 'Martina',
    'nationality': 'España',
    'second_name': null,
    'surname': 'Fraile Méndez'
  },
  'subscriber_request_date': '2022-02-24T13:45:10Z',
  'window_date': null
}"

Responses

Code Meaning Description Schema
201 Created Created None
204 No Content No Content None
400 Bad Request Bad Request None
401 Unauthorized Unauthorized None
500 Internal Server Error Internal Server Error None

Parameters

Name In Type Required Description
orgs path string true Tenant
processId path string true ProcessId would be accept

Request example

1
2
3


curl -X POST https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/portabilities/{processId}/accept

Responses

Code Meaning Description Schema
201 Created Created None
204 No Content No Content None
401 Unauthorized Unauthorized None
500 Internal Server Error Internal Server Error None

Parameters

Name In Type Required Description
orgs path string true Tenant
processId path string true ProcessId would be deny
body body DenyPortability false ‘none’

Request body - instance of DenyPortability

1
2
3

{
  "cause": "string"
}
Name Type Required Description
cause string false none

Request example

1
2
3
4
5
6
7


curl -X POST https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/portabilities/{processId}/deny \
  -H "Content-Type: application/json" \
 --data-raw "{
  'cause': 'string'
}"

Responses

Code Meaning Description Schema
201 Created Created None
204 No Content No Content None
400 Bad Request Bad Request None
401 Unauthorized Unauthorized None
500 Internal Server Error Internal Server Error None

Parameters

Name In Type Required Description
orgs path string true Tenant
msisdn path string true Msisdn

Request example

1
2
3
4


curl -X GET https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/ownerOperator/{msisdn} \
  -H "Accept: application/json"

Responses

Code Meaning Description Schema
200 OK successful operation [OwnerOperator]
404 Not Found Not Found None
500 Internal Server Error Internal Server Error None

200 - instance of OwnerOperator

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

[
  {
    "msisdn": "string",
    "nrn": "string",
    "codigoOperadorActual": "string",
    "codigoOperadorPropietarioRango": "string",
    "involucradaProcesoPortabilidad": true,
    "portada": true,
    "codigoReferenciaSolicitudPortabilidadMovil": "string",
    "codigoReferenciaIncidencia": [
      "string"
    ]
  }
]
Name Type Required Description
msisdn string false none
nrn string false none
codigoOperadorActual string false none
codigoOperadorPropietarioRango string false none
involucradaProcesoPortabilidad boolean false none
portada boolean false none
codigoReferenciaSolicitudPortabilidadMovil string false none
codigoReferenciaIncidencia [string] false none

Parameters

Name In Type Required Description
orgs path string true Tenant
processId path string true Process id

Request example

1
2
3


curl -X POST https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/portabilities/{processId}/restartReply

Responses

Code Meaning Description Schema
201 Created Created None
204 No Content No Content None
401 Unauthorized Unauthorized None
500 Internal Server Error Internal Server Error None

Parameters

Name In Type Required Description
orgs path string true Tenant
msisdn path string true Msisdn
body body DenyPortability false ‘none’

Request body - instance of DenyPortability

1
2
3

{
  "cause": "string"
}
Name Type Required Description
cause string false none

Request example

1
2
3
4
5
6
7


curl -X POST https://mas-portability.sta.masstack.com/v1/orgs/{orgs}/portabilities/{msisdn}/cancel \
  -H "Content-Type: application/json" \
 --data-raw "{
  'cause': 'string'
}"

Responses

Code Meaning Description Schema
201 Created Created None
204 No Content No Content None
400 Bad Request Bad Request None
401 Unauthorized Unauthorized None
500 Internal Server Error Internal Server Error None

Endpoints

Mobile portabilities

    Mobile operations