masstack

V2
API Overview Resources Schemas

Devices

Access to devices endpoints

Parameters

Name In Type Required Description
org_id path string true organization name
device_category query DeviceCategory false optional field to filter by device category
device_brand query string false optional field to filter by device brand
generic_code query string false optional field to filter by generic code device
Accept-Language header string false Flag to indicate the text language, relies on ISO-639-1
category_web query string false category web

Enumerated Values

Property Values
device_category one of [SMARTPHONE, SMARTWATCH, OTROS, ROUTER, TABLET, STB, WIFI_EXTENDER]
category_web one of [SMARTPHONE, TABLET, SMARTWATCH, SMART_TV, ROBOT_VACUUM_CLEANER, LAPTOP, SCOOTER, MONITOR, MODEM, GAMING, DEVICE, SCALE, HEADPHONE, SPEAKER, AIR_FRYER]

Request example

1
2
3
4
5
6


curl -X GET https://catalogue.masstack.com/v2/orgs/masmovil/devices?device_category='SMARTPHONE'&device_brand='SAMSUNG'&generic_code='P062P63'&category_web='LAPTOP' \
  -H "Accept: application/json" \
  -H "Accept-Language: es" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK OK [Device_Response]
400 Bad Request Bad request string
401 Unauthorized Unauthorized string
404 Not Found Item not found KOGenericResponse

200 - instance of Device_Response

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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

[
  {
    "id": "P045A1SNC",
    "generic_code": "P045A1S",
    "brand": "ALCATEL",
    "model": "ALCATEL 1S NEGRO",
    "name": "ALCATEL 1S NEGRO",
    "description": "string",
    "category": "SMARTPHONE",
    "colour": "NEGRO",
    "is_available": true,
    "include_preinstalled_sim": false,
    "image_url": "https://cdn.masmovil.com/Resources/broadband-phones/deviceid/deviceid.png",
    "category_web": "LAPTOP",
    "model_web": "ALCATEL 1S",
    "colour_name": "Midnight",
    "hexadecimal_colour": "#FF0000",
    "brand_colour": true,
    "specifications": "256GB / 6,1' / 5G 128GB / 6,2'",
    "control_app": false,
    "battery": "1530 mAh",
    "bluetooth_version": "5.0",
    "frontal_camera": "1 MP cámara recesiva",
    "back_camera": "1,3 MP",
    "storage": "2L",
    "wireless_charging": false,
    "fast_charge": false,
    "fast_charge_speed": "20W",
    "box_content": "Cargador Auriculares Fundas",
    "telecare_compatible": false,
    "connectivity": "WIFI y Bluetooth 5.0",
    "control_voice_assitant": false,
    "dimensions": "243,2 x 162,2 x 9,55 mm",
    "hard_drive": "256 GB",
    "dual_sim": false,
    "battery_duration": "Hasta 5 h de música; hasta 3 h en conversación; más de 24 h de música con el estuche de carga ",
    "esim": false,
    "flash": false,
    "functions": "Peso, BMI, grasa corporal, masa muscular, agua, proteína, grasa visceral, metabolismo basal, masa ósea, edad física, peso ideal, tipo de cuerpo y puntuación de salud",
    "touch_id": false,
    "max_speed": "25 km/h",
    "memory": "128 MB",
    "memory_expandable_to": "32GB (MicroSD)",
    "ram_memory": "128 MB",
    "microphone": true,
    "nfc": true,
    "user_number": "Hasta 16",
    "mapping_allowed": false,
    "weight": "200 g",
    "power": "20W",
    "gaming_capabilities": "HDR GiG, ALLM, Cloud Gaming Stadia y GeForce",
    "processor": "Procesador Inteligente α5 AI Processor 4K Gen6",
    "ports": "1 x HDMI, 1 x USB - C, 1 x USB 3.0, 2 x USB 2.0",
    "weight_range": "100 g - 150 kg",
    "network": "5G",
    "system_requirements": "iPad Pro de 11 pulgadas (1.ª, 2.ª o 3.ª generación) o iPad Air (4.ª generación) con iPadOS 14.5 o posterior",
    "water_resistant": false,
    "resolution": "HDR",
    "output": "2 HDMI y 1 USB",
    "noise_cancelling": false,
    "sensors": "Acelerómetro de 3 ejes, giroscopio de 3 ejes y sensor de frecuencia cardíaca PPG",
    "digital_tuner": "DVB-T2C",
    "os": "Android 10",
    "sound": "AI Sound (Virtual 5.1 Up-mix)",
    "size": "M",
    "screen_size": "1,47\"",
    "technology": "4G LTE",
    "battery_charge_time": "90 min (auricular) – 120 min (estuche con cable, sin los auriculares)​",
    "hard_drive_type": "SSD",
    "sim_type": "Nano SIM + MicroSD",
    "download_speed": "Descarga inalámbrica hasta 550 Mbps; 1 Gbps si es con cable",
    "wifi": "Wi-Fi 802.11a/b/g/n/ac/ax",
    "comments": "Además de ser ultra ligero y fino, cuenta con 8GB de RAM, para que ejecutes tanto tus juegos, como la multitarea de forma eficiente, con un aumento del rendimiento gracias a su mayor ancho de banda. Todo esto, con el sistema operativo Windows 11 Home 64. Gracias a su pantalla de 15,6” FHD proporciona una imagen detallada, clarísima y con los colores más vivos que nunca. Su disco duro SSD tiene una capacidad de 256 GB por lo que podrás guardar infinidad de archivos sin preocuparte por el espacio.",
    "promotional_info": {
      "trade_in_description": "Trade-in 200€: Desde el 11 de julio de 2024 hasta el 30 de marzo 2025. Más info disponible en timón.",
      "trade_in_value": 100,
      "additional_info": "Como promoción durante el periodo de preventa, los clientes podrán adquirir un smartphone de rango más alto de memoria por el mismo precio que uno de gama baja."
    },
    "energy_label": "B",
    "esim_only": false,
    "ean_code": "1234567890123"
  }
]
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

400 - JsonObject

Custom schema example

1

"Bad Request"
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

401 - JsonObject

Custom schema example

1

"Origin authentication failed."
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

404 - instance of KOGenericResponse

Custom schema example

1
2
3
4
5

{
  "error": "Item not found",
  "message": "Item not found",
  "code": "0200XX"
}
Name Type Required Description
error string false none
message string false none
code string false none

Parameters

Name In Type Required Description
org_id path string true organization name
commercial_profile_name query string true commercial profile name
device_category query DeviceCategory false optional field to filter by device category
device_brand query string false optional field to filter by device brand
generic_code query string false optional field to filter by generic code device
Accept-Language header string false Flag to indicate the text language, relies on ISO-639-1
category_web query string false category web

Enumerated Values

Property Values
device_category one of [SMARTPHONE, SMARTWATCH, OTROS, ROUTER, TABLET, STB, WIFI_EXTENDER]
category_web one of [SMARTPHONE, TABLET, SMARTWATCH, SMART_TV, ROBOT_VACUUM_CLEANER, LAPTOP, SCOOTER, MONITOR, MODEM, GAMING, DEVICE, SCALE, HEADPHONE, SPEAKER, AIR_FRYER]

Request example

1
2
3
4
5
6


curl -X GET https://catalogue.masstack.com/v2/orgs/masmovil/devices/sellable?commercial_profile_name='perfil_comercial.postpago_ventas_pos'&device_category='SMARTPHONE'&device_brand='SAMSUNG'&generic_code='P062P63'&category_web='LAPTOP'?commercial_profile_name=perfil_comercial.postpago_ventas_pos \
  -H "Accept: application/json" \
  -H "Accept-Language: es" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK OK [Device_Response]
400 Bad Request Bad request string
401 Unauthorized Unauthorized string
404 Not Found Item not found KOGenericResponse

200 - instance of Device_Response

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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

[
  {
    "id": "P045A1SNC",
    "generic_code": "P045A1S",
    "brand": "ALCATEL",
    "model": "ALCATEL 1S NEGRO",
    "name": "ALCATEL 1S NEGRO",
    "description": "string",
    "category": "SMARTPHONE",
    "colour": "NEGRO",
    "is_available": true,
    "include_preinstalled_sim": false,
    "image_url": "https://cdn.masmovil.com/Resources/broadband-phones/deviceid/deviceid.png",
    "category_web": "LAPTOP",
    "model_web": "ALCATEL 1S",
    "colour_name": "Midnight",
    "hexadecimal_colour": "#FF0000",
    "brand_colour": true,
    "specifications": "256GB / 6,1' / 5G 128GB / 6,2'",
    "control_app": false,
    "battery": "1530 mAh",
    "bluetooth_version": "5.0",
    "frontal_camera": "1 MP cámara recesiva",
    "back_camera": "1,3 MP",
    "storage": "2L",
    "wireless_charging": false,
    "fast_charge": false,
    "fast_charge_speed": "20W",
    "box_content": "Cargador Auriculares Fundas",
    "telecare_compatible": false,
    "connectivity": "WIFI y Bluetooth 5.0",
    "control_voice_assitant": false,
    "dimensions": "243,2 x 162,2 x 9,55 mm",
    "hard_drive": "256 GB",
    "dual_sim": false,
    "battery_duration": "Hasta 5 h de música; hasta 3 h en conversación; más de 24 h de música con el estuche de carga ",
    "esim": false,
    "flash": false,
    "functions": "Peso, BMI, grasa corporal, masa muscular, agua, proteína, grasa visceral, metabolismo basal, masa ósea, edad física, peso ideal, tipo de cuerpo y puntuación de salud",
    "touch_id": false,
    "max_speed": "25 km/h",
    "memory": "128 MB",
    "memory_expandable_to": "32GB (MicroSD)",
    "ram_memory": "128 MB",
    "microphone": true,
    "nfc": true,
    "user_number": "Hasta 16",
    "mapping_allowed": false,
    "weight": "200 g",
    "power": "20W",
    "gaming_capabilities": "HDR GiG, ALLM, Cloud Gaming Stadia y GeForce",
    "processor": "Procesador Inteligente α5 AI Processor 4K Gen6",
    "ports": "1 x HDMI, 1 x USB - C, 1 x USB 3.0, 2 x USB 2.0",
    "weight_range": "100 g - 150 kg",
    "network": "5G",
    "system_requirements": "iPad Pro de 11 pulgadas (1.ª, 2.ª o 3.ª generación) o iPad Air (4.ª generación) con iPadOS 14.5 o posterior",
    "water_resistant": false,
    "resolution": "HDR",
    "output": "2 HDMI y 1 USB",
    "noise_cancelling": false,
    "sensors": "Acelerómetro de 3 ejes, giroscopio de 3 ejes y sensor de frecuencia cardíaca PPG",
    "digital_tuner": "DVB-T2C",
    "os": "Android 10",
    "sound": "AI Sound (Virtual 5.1 Up-mix)",
    "size": "M",
    "screen_size": "1,47\"",
    "technology": "4G LTE",
    "battery_charge_time": "90 min (auricular) – 120 min (estuche con cable, sin los auriculares)​",
    "hard_drive_type": "SSD",
    "sim_type": "Nano SIM + MicroSD",
    "download_speed": "Descarga inalámbrica hasta 550 Mbps; 1 Gbps si es con cable",
    "wifi": "Wi-Fi 802.11a/b/g/n/ac/ax",
    "comments": "Además de ser ultra ligero y fino, cuenta con 8GB de RAM, para que ejecutes tanto tus juegos, como la multitarea de forma eficiente, con un aumento del rendimiento gracias a su mayor ancho de banda. Todo esto, con el sistema operativo Windows 11 Home 64. Gracias a su pantalla de 15,6” FHD proporciona una imagen detallada, clarísima y con los colores más vivos que nunca. Su disco duro SSD tiene una capacidad de 256 GB por lo que podrás guardar infinidad de archivos sin preocuparte por el espacio.",
    "promotional_info": {
      "trade_in_description": "Trade-in 200€: Desde el 11 de julio de 2024 hasta el 30 de marzo 2025. Más info disponible en timón.",
      "trade_in_value": 100,
      "additional_info": "Como promoción durante el periodo de preventa, los clientes podrán adquirir un smartphone de rango más alto de memoria por el mismo precio que uno de gama baja."
    },
    "energy_label": "B",
    "esim_only": false,
    "ean_code": "1234567890123"
  }
]
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

400 - JsonObject

Custom schema example

1

"Bad Request"
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

401 - JsonObject

Custom schema example

1

"Origin authentication failed."
Name Type Required Description
id string false none
generic_code string false none
brand string false none
model string false none
name string false none
description string false none
category string false none
colour string false none
is_available boolean false based on this attribute we know if a device is active or not
include_preinstalled_sim boolean false if the device has a built-in sim card
image_url string(url)¦null false url to device image
category_web string false none
model_web string false none
colour_name string false none
hexadecimal_colour string false none
brand_colour boolean false none
specifications string false none
control_app boolean false none
battery string false none
bluetooth_version string false none
frontal_camera string false none
back_camera string false none
storage string false none
wireless_charging boolean false none
fast_charge boolean false none
fast_charge_speed string false none
box_content string false none
telecare_compatible boolean false none
connectivity string false none
control_voice_assitant boolean false none
dimensions string false none
hard_drive string false none
dual_sim boolean false none
battery_duration string false none
esim boolean false none
flash boolean false none
functions string false none
touch_id boolean false none
max_speed string false none
memory string false none
memory_expandable_to string false none
ram_memory string false none
microphone boolean false none
nfc boolean false none
user_number string false none
mapping_allowed boolean false none
weight string false none
power string false none
gaming_capabilities string false none
processor string false none
ports string false none
weight_range string false none
network string false none
system_requirements string false none
water_resistant boolean false none
resolution string false none
output string false none
noise_cancelling boolean false none
sensors string false none
digital_tuner string false none
os string false none
sound string false none
size string false none
screen_size string false none
technology string false none
battery_charge_time string false none
hard_drive_type string false none
sim_type string false none
download_speed string false none
wifi string false none
comments string false none
promotional_info PromotionalInfo false none
energy_label string false none
esim_only boolean false none
ean_code string false none

404 - instance of KOGenericResponse

Custom schema example

1
2
3
4
5

{
  "error": "Item not found",
  "message": "Item not found",
  "code": "0200XX"
}
Name Type Required Description
error string false none
message string false none
code string false none

Parameters

Name In Type Required Description
org_id path string true organization name
device_id path string true device identifier
Accept-Language header string false Flag to indicate the text language, relies on ISO-639-1

Request example

1
2
3
4
5
6


curl -X GET https://catalogue.masstack.com/v2/orgs/masmovil/devices/P045A1SNC \
  -H "Accept: application/json" \
  -H "Accept-Language: es" \
  -H "Authorization: Bearer {access-token}"

Responses

Code Meaning Description Schema
200 OK OK Device_Response
400 Bad Request Bad request string
401 Unauthorized Unauthorized string
404 Not Found Item not found KOGenericResponse

Endpoints

Commercial Products

    Bundled Products

      Bundled Commercial Products

        Free Units Packages

          Promotions

            Commercial Devices

              Rate Plans

                Base profiles and services

                  Value Added Services

                    Services

                      Commercial Infos

                        Transaction types

                          Devices

                            Commercial profiles

                              Misc services