{"openapi":"3.0.3","info":{"title":"FullDatos API v2","description":"B2B eSIM marketplace API para la gestión de eSIMs, paquetes, pedidos, usuarios y demás. Las autenticaciones se realizan mediante los encabezados `x-api-key` y `x-api-secret`.\n\n[Solicitar API Keys](mailto:support@fulldatos.app?subject=Solicitud%20de%20API%20Keys)","version":"1.0.0","contact":{"name":"Soporte API","email":"support@fulldatos.app"}},"components":{"schemas":{}},"paths":{"/users":{"get":{"summary":"Obtener todos los usuarios","tags":["Users"],"description":"Recupera todos los usuarios asociados a tu oganización. Requiere autenticación. Puedes filtrar po un usuario específico usando el parámetro de consulta reference_id. Devuelve una lista de usuarios con sus detalles.","parameters":[{"schema":{"minimum":1,"type":"number"},"in":"query","name":"limit","required":false,"description":"Número máximo de usuarios a devolver"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"page","required":false,"description":"Número de página. La página 1 devuelve el primer conjunto de resultados."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"user_id":{"type":"string"},"esims_amount":{"type":"number"},"orders_amount":{"type":"number"},"last_order":{"type":"string"},"last_esim":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"esim_ids":{"type":"array","items":{"type":"string"}},"order_ids":{"type":"array","items":{"type":"string"}}},"required":["user_id","esims_amount","orders_amount","last_order","last_esim","created_at","updated_at","esim_ids","order_ids"]}}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/users/{user_id}":{"get":{"summary":"Obtener usuario por ID","tags":["Users"],"description":"Recupera un usuario po su ID. Requiere autenticación. Devuelve los detalles del usuario incluyendo sus eSIMs y pedidos.","parameters":[{"schema":{"type":"string"},"in":"path","name":"user_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"user_id":{"type":"string"},"esims_amount":{"type":"number"},"orders_amount":{"type":"number"},"last_order":{"type":"string"},"last_esim":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"esims":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"order_id":{"type":"string"},"provider":{"type":"string"},"qr_link":{"type":"string"},"installation_status":{"type":"boolean"},"bundles_count":{"type":"number"},"last_bundle":{"type":"object","properties":{"sku":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"unlimited":{"type":"boolean"}},"required":["sku","bundle_description_spanish","bundle_description_english","unlimited"]},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]}},"required":["esim_id","created_at","updated_at","order_id","qr_link","installation_status","bundles_count","expired","fulfilled","refund_status"]}},"orders":{"type":"array","items":{"type":"object","properties":{"order_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"description":{"type":"string"},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"products_count":{"type":"number"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"top_up":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"unlimited":{"type":"boolean"}},"required":["sku","bundle_description_spanish","bundle_description_english","unlimited"]}}},"required":["esim_id","top_up","fulfilled","refund_status","bundles"]}}},"required":["order_id","created_at","updated_at","description","price","currency","fulfilled","refund_status","products_count","products"]}}},"required":["user_id","esims_amount","orders_amount","last_order","last_esim","created_at","updated_at","esims","orders"]}},"required":["success","data"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}},"put":{"summary":"Actualizar el ID de un usuario","tags":["Users"],"description":"Actualiza el ID de referencia de un usuario existente. Requiere autenticación. Solo se pueden actualizar usuarios dentro de tu oganización. Se usa el ID de usuario actual para identificar al usuario y asignarle un nuevo ID","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reference_id":{"type":"string"}},"required":["reference_id"]}}},"required":true},"parameters":[{"schema":{"type":"string"},"in":"path","name":"user_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"reference_id":{"type":"string"}},"required":["reference_id"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}},"delete":{"summary":"Eliminar un usuario","tags":["Users"],"description":"Elimina permanentemente un usuario de tu oganización usando su user_id. Requiere autenticación. Esta acción no se puede deshacer. Todos los datos asociados serán eliminados del sistema.","parameters":[{"schema":{"type":"string"},"in":"path","name":"user_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/orders":{"post":{"summary":"Crear un nuevo pedido","tags":["Orders"],"description":"Crea un nuevo pedido para aprovisionamiento de eSIM. Requiere autenticación. Especifica el usuario, oferta de paquete y detalles del pedido. El sistema procesará el pedido, aprovisionará la eSIM del proveedo y devolverá los detalles del pedido incluyendo la infomación de la eSIM (ICCID, códigos de activación, etc.).","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"sku":{"type":"array","items":{"type":"string"}}},"required":["sku"]}},"user":{"type":"string"},"create_user":{"type":"boolean"}},"required":["products"]}}},"required":true},"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"order_id":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"qr_link":{"type":"string"},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"sku":{"type":"array","items":{"type":"string"}},"new":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}}},"required":["esim_id","qr_link","bundles","sku","new","fulfilled","refund_status","profile"]}},"user_id":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"fulfilled":{"type":"boolean"},"processing_status":{"anyOf":[{"type":"string","enum":["processing"]},{"type":"string","enum":["successful"]},{"type":"string","enum":["failed"]}]},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["order_id","products","user_id","description","created_at","updated_at","fulfilled","processing_status","refund_status","price","currency"]}},"required":["success","message","data"]}}}},"206":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"order_id":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"qr_link":{"type":"string"},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"sku":{"type":"array","items":{"type":"string"}},"new":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}}},"required":["esim_id","qr_link","bundles","sku","new","fulfilled","refund_status","profile"]}},"user_id":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"fulfilled":{"type":"boolean"},"processing_status":{"anyOf":[{"type":"string","enum":["processing"]},{"type":"string","enum":["successful"]},{"type":"string","enum":["failed"]}]},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["order_id","products","user_id","description","created_at","updated_at","fulfilled","processing_status","refund_status","price","currency"]}},"required":["success","message","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"},"required_amount":{"type":"number"},"available_balance":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["success","message","required_amount","available_balance","currency"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"order_id":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"qr_link":{"type":"string"},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"sku":{"type":"array","items":{"type":"string"}},"new":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}}},"required":["esim_id","qr_link","bundles","sku","new","fulfilled","refund_status","profile"]}},"user_id":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"fulfilled":{"type":"boolean"},"processing_status":{"anyOf":[{"type":"string","enum":["processing"]},{"type":"string","enum":["successful"]},{"type":"string","enum":["failed"]}]},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["order_id","products","user_id","description","created_at","updated_at","fulfilled","processing_status","refund_status","price","currency"]}},"required":["success","message","data"]}}}}}},"get":{"summary":"Obtener todos los pedidos","tags":["Orders"],"description":"Recupera todos los pedidos de tu oganización. Requiere autenticación. Puedes filtrar pedidos po usuario usando el parámetro de consulta. Devuelve una lista de pedidos con su estado, detalles de eSIM, infomación de paquetes e histoial de transacciones.","parameters":[{"schema":{"type":"string"},"in":"query","name":"user","required":false},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"limit","required":false,"description":"Número máximo de pedidos a devolver"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"page","required":false,"description":"Número de página. La página 1 devuelve el primer conjunto de resultados."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"order_id":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"qr_link":{"type":"string"},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"sku":{"type":"array","items":{"type":"string"}},"new":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}}},"required":["esim_id","qr_link","bundles","sku","new","fulfilled","refund_status","profile"]}},"user_id":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"fulfilled":{"type":"boolean"},"processing_status":{"anyOf":[{"type":"string","enum":["processing"]},{"type":"string","enum":["successful"]},{"type":"string","enum":["failed"]}]},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["order_id","products","user_id","description","created_at","updated_at","fulfilled","processing_status","refund_status","price","currency"]}}},"required":["success","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/orders/{order_id}":{"get":{"summary":"Obtener pedido por ID","tags":["Orders"],"description":"Recupera un pedido po su oder_id de tu oganización. Requiere autenticación. Devuelve los detalles del pedido incluyendo estado, infomación de eSIM, detalles de paquetes e histoial de transacciones.","parameters":[{"schema":{"type":"string"},"in":"path","name":"order_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"order_id":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"qr_link":{"type":"string"},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"sku":{"type":"array","items":{"type":"string"}},"new":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}}},"required":["esim_id","qr_link","bundles","sku","new","fulfilled","refund_status","profile"]}},"user_id":{"type":"string"},"description":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"fulfilled":{"type":"boolean"},"processing_status":{"anyOf":[{"type":"string","enum":["processing"]},{"type":"string","enum":["successful"]},{"type":"string","enum":["failed"]}]},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"price":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]}},"required":["order_id","products","user_id","description","created_at","updated_at","fulfilled","processing_status","refund_status","price","currency"]}},"required":["success","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/esims":{"get":{"summary":"Obtener todas las eSIMs","tags":["eSIMs"],"description":"Recupera todas las eSIMs asociadas a tu oganización. Requiere autenticación. Devuelve una lista de todas las eSIMs con sus detalles incluyendo ID de eSIM, estado de activación e infomación del usuario asociado.","parameters":[{"schema":{"minimum":1,"type":"number"},"in":"query","name":"limit","required":false,"description":"Número máximo de eSIMs a devolver"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"page","required":false,"description":"Número de página. La página 1 devuelve el primer conjunto de resultados."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"order_id":{"type":"string"},"user_id":{"type":"string"},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}},"qr_link":{"type":"string"},"smdp_address":{"type":"string"},"activation_code":{"type":"string"},"full_activation_code":{"type":"string"},"apple_instalation_link":{"type":"string"},"installation_status":{"type":"boolean"},"detailed_installation_status":{"type":"string"},"installation_date":{"format":"date-time","type":"string"},"successful_installations":{"type":"number"},"successful_installations_limit":{"type":"number"},"expiration_date":{"format":"date-time","type":"string"},"last_use":{"format":"date-time","type":"string"},"last_bundle":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_identifier":{"type":"string"},"bundle_iso_code":{"type":"string"},"unlimited":{"type":"boolean"},"days":{"type":"number"},"capacity":{"type":"number"}},"required":["sku","bundle_id","provider_bundle_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_identifier","bundle_iso_code","unlimited","days","capacity"]},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"deleted":{"type":"boolean"},"changes":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"source":{"type":"string"},"date":{"format":"date-time","type":"string"}},"required":["type","date"]}},"error_message":{"type":"string"},"other_params":{"type":"object","properties":{}},"bundles":{"type":"array","items":{"type":"string"}}},"required":["esim_id","created_at","updated_at","order_id","qr_link","smdp_address","activation_code","full_activation_code","apple_instalation_link","installation_status","detailed_installation_status","expiration_date","last_use","expired","fulfilled","refund_status","deleted","changes","bundles"]}}},"required":["success","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/esims/{esim_id}":{"get":{"summary":"Obtener estado de eSIM","tags":["eSIMs"],"description":"Recupera el estado actual y detalles de una eSIM directamente del proveedo. Requiere autenticación. Propociona el ID de la eSIM para obtener infomación en tiempo real incluyendo estado de activación, uso de datos, saldo restante y conectividad de red. Este endpoint consulta la API del proveedo para obtener la infomación más actualizada.","parameters":[{"schema":{"type":"string"},"in":"path","name":"esim_id","required":true,"description":"eSIM identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"esim_id":{"type":"string"},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"},"order_id":{"type":"string"},"user_id":{"type":"string"},"provider":{"type":"string"},"profile":{"type":"array","items":{"type":"string"}},"qr_link":{"type":"string"},"smdp_address":{"type":"string"},"activation_code":{"type":"string"},"full_activation_code":{"type":"string"},"apple_instalation_link":{"type":"string"},"installation_status":{"type":"boolean"},"detailed_installation_status":{"type":"string"},"installation_date":{"format":"date-time","type":"string"},"successful_installations":{"type":"number"},"successful_installations_limit":{"type":"number"},"expiration_date":{"format":"date-time","type":"string"},"last_use":{"format":"date-time","type":"string"},"last_bundle":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_identifier":{"type":"string"},"bundle_iso_code":{"type":"string"},"unlimited":{"type":"boolean"},"days":{"type":"number"},"capacity":{"type":"number"}},"required":["sku","bundle_id","provider_bundle_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_identifier","bundle_iso_code","unlimited","days","capacity"]},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"deleted":{"type":"boolean"},"changes":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"source":{"type":"string"},"date":{"format":"date-time","type":"string"}},"required":["type","date"]}},"error_message":{"type":"string"},"other_params":{"type":"object","properties":{}},"bundles":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"regional":{"type":"boolean"},"bundle_id":{"type":"string"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"expired":{"type":"boolean"},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","regional","bundle_id","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","fulfilled","refund_status","expired","voice_allowed","profile","countries_included"]}}},"required":["esim_id","created_at","updated_at","order_id","qr_link","smdp_address","activation_code","full_activation_code","apple_instalation_link","installation_status","detailed_installation_status","expiration_date","last_use","expired","fulfilled","refund_status","deleted","changes","bundles"]}},"required":["success","message","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/bundles":{"get":{"summary":"Obtener todos los paquetes","tags":["Bundles"],"description":"Recupera todos los paquetes comprados asociados a tu oganización. Requiere autenticación. Devuelve una lista de todos los paquetes con sus detalles incluyendo uso de datos, validez, estado e infomación de la eSIM asociada.","parameters":[{"schema":{"minimum":1,"type":"number"},"in":"query","name":"limit","required":false,"description":"Número máximo de paquetes a devolver"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"page","required":false,"description":"Número de página. La página 1 devuelve el primer conjunto de resultados."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}}},"required":["success","message","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/bundles/{bundle_id}":{"get":{"summary":"Obtener paquete por ID","tags":["Bundles"],"description":"Recupera el estado actual y detalles de un paquete específico directamente del proveedo. Requiere autenticación. Propociona el identificado del paquete para obtener infomación en tiempo real incluyendo uso de datos, saldo restante, período de validez y estado de activación. Este endpoint consulta la API del proveedo para obtener la infomación más actualizada.","parameters":[{"schema":{"type":"string"},"in":"path","name":"bundle_id","required":true,"description":"Bundle identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"sku":{"type":"string"},"bundle_id":{"type":"string"},"provider_bundle_id":{"type":"string"},"override_provider_bundle":{"type":"string"},"esim_id":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"regional":{"type":"boolean"},"activation_status":{"type":"boolean"},"activation_date":{"format":"date-time","type":"string"},"expiration_date":{"format":"date-time","type":"string"},"activation_window_expiration_date":{"format":"date-time","type":"string"},"unlimited":{"type":"boolean"},"unlimited_data":{"type":"object","properties":{"daily_use_limit":{"type":"number"},"speed_limit":{"type":"number"},"day_use":{"type":"number"},"day_remaining":{"type":"number"},"day_percentage":{"type":"number"}},"required":["daily_use_limit","speed_limit","day_use","day_remaining","day_percentage"]},"days":{"type":"number"},"capacity":{"type":"number"},"remaining":{"type":"number"},"used":{"type":"number"},"percentage":{"type":"number"},"expired":{"type":"boolean"},"fulfilled":{"type":"boolean"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"error_message":{"type":"string"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"other_params":{"type":"object","properties":{}}},"required":["sku","bundle_id","esim_id","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_iso_code","regional","activation_status","activation_window_expiration_date","unlimited","unlimited_data","days","capacity","remaining","used","percentage","expired","fulfilled","refund_status","voice_allowed","profile","countries_included"]}},"required":["success","message","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/refund":{"post":{"summary":"Reembolsar paquetes, eSIMs o pedidos","tags":["Refunds"],"description":"Endpoint unificado de reembolsos. Sopota 4 modos:\n\n1. **eSIM individual (todos los paquetes):** `{ \"esim_id\": \"...\" }`\n2. **Paquetes específicos:** `{ \"esim_id\": \"...\", \"bundle_ids\": [\"...\"] }`\n3. **Pedido completo:** `{ \"oder_id\": \"...\" }`\n4. **eSIMs específicas de un pedido:** `{ \"oder_id\": \"...\", \"esim_ids\": [\"...\"] }`\n\nPropociona ya sea `esim_id` o `oder_id`, no ambos. Credits are returned to the oganization balance automatically.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"esim_id":{"description":"eSIM identifier. Refund this eSIM (all bundles or specific ones via bundle_ids).","type":"string"},"bundle_ids":{"minItems":1,"description":"Only valid together with esim_id. If omitted, all bundles of the eSIM are refunded.","type":"array","items":{"description":"Bundle IDs to refund","type":"string"}},"order_id":{"description":"Order document ID (_id). Refund the entire order or specific eSIMs via esim_ids.","type":"string"},"esim_ids":{"minItems":1,"description":"Only valid together with order_id. If omitted, all eSIMs in the order are refunded.","type":"array","items":{"description":"eSIM identifiers to refund within the order","type":"string"}}}}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"},"bundle_results":{"type":"array","items":{"type":"object","properties":{"bundle_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"}},"required":["bundle_id","refund_status","status","success","message"]}}},"required":["esim_id","refund_status","status","success","message"]}}},"required":["success","message","results"]}}}},"206":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"},"bundle_results":{"type":"array","items":{"type":"object","properties":{"bundle_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"}},"required":["bundle_id","refund_status","status","success","message"]}}},"required":["esim_id","refund_status","status","success","message"]}}},"required":["success","message"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"esim_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["partially_refunded"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"},"bundle_results":{"type":"array","items":{"type":"object","properties":{"bundle_id":{"type":"string"},"refund_status":{"anyOf":[{"type":"string","enum":["none"]},{"type":"string","enum":["refunded"]}]},"status":{"type":"number"},"success":{"type":"boolean"},"message":{"type":"string"}},"required":["bundle_id","refund_status","status","success","message"]}}},"required":["esim_id","refund_status","status","success","message"]}}},"required":["success","message"]}}}}}}},"/credits/balance":{"get":{"summary":"Obtener balance de créditos de la organización","tags":["Credits"],"description":"Recupera el balance de créditos actual (USD y MXN) de la oganización autenticada.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"organization_id":{"type":"string"},"balance_usd":{"type":"number"},"balance_mxn":{"type":"number"}},"required":["organization_id","balance_usd","balance_mxn"]}},"required":["success","data"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/credits/transactions":{"get":{"summary":"Obtener historial de transacciones de créditos","tags":["Credits"],"description":"Recupera el histoial de transacciones de créditos de la oganización autenticada. Sopota filtrado po moneda y paginación.","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]},"in":"query","name":"currency","required":false},{"schema":{"minimum":1,"maximum":100,"default":50,"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"minimum":0,"default":0,"type":"number"},"in":"query","name":"offset","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"transactions":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string"},"transaction_type":{"anyOf":[{"type":"string","enum":["credit"]},{"type":"string","enum":["debit"]}]},"amount":{"type":"number"},"currency":{"anyOf":[{"type":"string","enum":["usd"]},{"type":"string","enum":["mxn"]}]},"balance_after":{"type":"number"},"description":{"type":"string"},"reference_type":{"anyOf":[{"type":"string","enum":["order"]},{"type":"string","enum":["refund"]},{"type":"string","enum":["manual"]}]},"reference_id":{"type":"string"},"created_at":{"type":"string"}},"required":["_id","transaction_type","amount","currency","balance_after","description","created_at"]}},"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"}},"required":["transactions","total","limit","offset"]}},"required":["success","data"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/status":{"get":{"summary":"Obtener estados de red de los últimos 31 días","tags":["Status"],"description":"Returns all netwok status entries created o updated in the last 31 days. No ejecuta verificaciones de salud. Requiere autenticación de oganización.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"sector":{"anyOf":[{"type":"string","enum":["api_v2"]},{"type":"string","enum":["platform_api"]},{"type":"string","enum":["admin_platform_website"]},{"type":"string","enum":["esim_connectivity"]},{"type":"string","enum":["esim_installations"]},{"type":"string","enum":["provider_a_api"]},{"type":"string","enum":["provider_b_api"]},{"type":"string","enum":["provider_c_api"]},{"type":"string","enum":["provider_d_api"]}]},"subtitle_spanish":{"type":"string"},"subtitle_english":{"type":"string"},"updates":{"type":"array","items":{"type":"object","properties":{"message_spanish":{"type":"string"},"message_english":{"type":"string"},"new_status":{"anyOf":[{"type":"string","enum":["fully_operational"]},{"type":"string","enum":["monitoring"]},{"type":"string","enum":["degraded"]},{"type":"string","enum":["down"]}]},"date":{"format":"date-time","type":"string"},"updated_by":{"type":"string"}},"required":["message_spanish","message_english","new_status","date","updated_by"]}},"created_at":{"format":"date-time","type":"string"},"updated_at":{"format":"date-time","type":"string"}},"required":["sector","subtitle_spanish","subtitle_english","updates","created_at","updated_at"]}}},"required":["success","data"]}}}}}}},"/status/check":{"post":{"summary":"Ejecutar todas las verificaciones de salud","tags":["Status"],"description":"Runs health checks fo API, database, and all providers. Creates new netwok status entries fo each check. Requiere autenticación de oganización.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/tickets":{"post":{"summary":"Enviar un ticket de soporte","tags":["Tickets"],"description":"Submit a suppot ticket fo the authenticated oganization. The ticket will be routed to the appropriate internal team based on the categoy. Use GET /tickets/categoies to see available categoies.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category_key":{"description":"Ticket category key (e.g. system_failure, general_question)","type":"string"},"subject":{"minLength":1,"maxLength":200,"description":"Brief summary of the issue","type":"string"},"description":{"minLength":1,"maxLength":5000,"description":"Detailed description of the issue","type":"string"},"priority":{"anyOf":[{"type":"string","enum":["low"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["high"]}]},"emails_notified":{"minItems":1,"description":"Team emails to notify","type":"array","items":{"format":"email","type":"string"}}},"required":["category_key","subject","description","priority"]}}},"required":true},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"message":{"type":"string"},"data":{"type":"object","properties":{"ticket_id":{"type":"string"},"category":{"type":"string"},"priority":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"}},"required":["ticket_id","category","priority","status","created_at"]}},"required":["success","message","data"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}},"get":{"summary":"Obtener tickets de la organización","tags":["Tickets"],"description":"Retrieves all tickets submitted by the authenticated oganization, soted by newest first.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"_id":{"type":"string"},"ticket_id":{"type":"string"},"organization_object_id":{"type":"string"},"organization_id":{"type":"string"},"category_key":{"type":"string"},"category_display_name":{"type":"string"},"priority":{"anyOf":[{"type":"string","enum":["low"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["high"]}]},"subject":{"type":"string"},"description":{"type":"string"},"submitted_by_account_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"organization_admin_email":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["submitted"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["closed"]}]},"emails_notified":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["_id","ticket_id","organization_object_id","organization_id","category_key","category_display_name","priority","subject","description","submitted_by_account_email","organization_admin_email","status","emails_notified","created_at","updated_at"]}},"count":{"type":"number"}},"required":["success","data","count"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/tickets/{ticket_id}":{"get":{"summary":"Obtener ticket por ID","tags":["Tickets"],"description":"Recupera un ticket específico por su ticket_id. Only returns tickets belonging to the authenticated oganization.","parameters":[{"schema":{"type":"string"},"in":"path","name":"ticket_id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"_id":{"type":"string"},"ticket_id":{"type":"string"},"organization_object_id":{"type":"string"},"organization_id":{"type":"string"},"category_key":{"type":"string"},"category_display_name":{"type":"string"},"priority":{"anyOf":[{"type":"string","enum":["low"]},{"type":"string","enum":["medium"]},{"type":"string","enum":["high"]}]},"subject":{"type":"string"},"description":{"type":"string"},"submitted_by_account_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"organization_admin_email":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["submitted"]},{"type":"string","enum":["in_progress"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["closed"]}]},"emails_notified":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["_id","ticket_id","organization_object_id","organization_id","category_key","category_display_name","priority","subject","description","submitted_by_account_email","organization_admin_email","status","emails_notified","created_at","updated_at"]}},"required":["success","data"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/tickets/categories":{"get":{"summary":"Obtener categorías de tickets disponibles","tags":["Tickets"],"description":"Retrieves all active ticket categoies. Use the categoy_key when submitting a ticket via POST /tickets.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"category_key":{"type":"string"},"display_name_spanish":{"type":"string"},"display_name_english":{"type":"string"}},"required":["category_key","display_name_spanish","display_name_english"]}},"count":{"type":"number"}},"required":["success","data","count"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/catalog/destinations":{"get":{"summary":"Obtener todos los países con cobertura","tags":["Catalog"],"description":"Devuelve una lista de todos los países con cobertura, dadas las ofertas de paquetes. Agrega datos de todas las ofertas de paquetes para mostrar destinos únicos con conteo de paquetes, SKUs y precios mínimos.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"destinations":{"type":"array","items":{"type":"object","properties":{"country_name_english":{"type":"string"},"country_name_spanish":{"type":"string"},"country_identifier":{"type":"string"},"iso_code":{"type":"string"},"bundle_count":{"type":"number"},"skus":{"type":"array","items":{"type":"string"}},"min_price_usd":{"type":"number"},"min_price_mxn":{"type":"number"}},"required":["country_name_english","country_name_spanish","country_identifier","iso_code","bundle_count","skus","min_price_usd","min_price_mxn"]}}},"required":["destinations"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/catalog/bundle-offers":{"get":{"summary":"Obtener todas las ofertas de paquetes","tags":["Catalog"],"description":"Devuelve una lista de todas las ofertas de paquetes disponibles en el sistema. Soporta filtrado por país, capacidad de datos (GB mínimo/máximo), duración de validez (días mínimo/máximo), SKU, perfil y estado. Devuelve detalles de las ofertas de paquetes incluyendo precios, cantidad de datos, validez e información del proveedor.","parameters":[{"schema":{"type":"string"},"in":"query","name":"sku","required":false},{"schema":{"type":"string"},"in":"query","name":"country","required":false,"description":"Filtro por código ISO de país o región (ej. US, MX, ASIA, EURO)"},{"schema":{"type":"string"},"in":"query","name":"bundle_identifier","required":false,"description":"Filter by bundle identifier slug (e.g. latin_america, europe, mexico)"},{"schema":{"type":"array","items":{"description":"Filter by compatibility profile, A1 to C3.","type":"string"}},"in":"query","name":"profile","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false,"description":"Filtro por disponibilidad. `active` devuelve solo paquetes disponibles, `inactive` devuelve solo paquetes no disponibles."},{"schema":{"minimum":0,"type":"number"},"in":"query","name":"min_capacity","required":false,"description":"Cantidad mínima de GB disponibles"},{"schema":{"minimum":0,"type":"number"},"in":"query","name":"max_capacity","required":false,"description":"Cantidad máxima de GB disponibles"},{"schema":{"minimum":0,"type":"number"},"in":"query","name":"min_days","required":false,"description":"Duración mínima de validez en días"},{"schema":{"minimum":0,"type":"number"},"in":"query","name":"max_days","required":false,"description":"Duración máxima de validez en días"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"limit","required":false,"description":"Número máximo de ofertas de paquetes a obtener"},{"schema":{"minimum":1,"type":"number"},"in":"query","name":"page","required":false,"description":"Número de página. La página 1 devuelve el primer conjunto de resultados."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"created_at":{"type":"string"},"updated_at":{"type":"string"},"available":{"type":"boolean"},"sku":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_identifier":{"type":"string"},"bundle_iso_code":{"type":"string"},"bundle_price_mxn":{"type":"number"},"bundle_price_usd":{"type":"number"},"bundle_validity":{"type":"number"},"bundle_capacity":{"type":"number"},"unlimited":{"type":"boolean"},"unlimited_daily_use_limit":{"type":"number"},"unlimited_speed_limit":{"type":"number"},"activation_window_validity":{"type":"number"},"regional":{"type":"boolean"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"tier_pricing":{"type":"array","items":{"type":"object","properties":{"tier":{"anyOf":[{"type":"string","enum":["starter"]},{"type":"string","enum":["bronze"]},{"type":"string","enum":["silver"]},{"type":"string","enum":["gold"]},{"type":"string","enum":["platinum"]},{"type":"string","enum":["datosdeviaje"]}]},"price_usd":{"minimum":0,"type":"number"},"price_mxn":{"minimum":0,"type":"number"}},"required":["tier","price_usd","price_mxn"]}},"current_provider":{"type":"string"},"current_provider_bundle":{"type":"string"},"provider_bundle_array":{"type":"array","items":{"type":"string"}},"suggested_countries_not_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"bundle_identifier":{"type":"string"}},"required":["country_name_spanish","country_name_english","bundle_iso_code","bundle_identifier"]}},"optimized":{"type":"boolean"},"other_params":{"type":"object","properties":{}}},"required":["created_at","updated_at","available","sku","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_identifier","bundle_iso_code","bundle_price_mxn","bundle_price_usd","bundle_validity","bundle_capacity","unlimited","unlimited_daily_use_limit","unlimited_speed_limit","activation_window_validity","regional","voice_allowed","profile","countries_included"]}},"count":{"type":"number"}},"required":["success","data","count"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/catalog/bundle-offers/{sku}":{"get":{"summary":"Obtener oferta de paquete por SKU","tags":["Catalog"],"description":"Obtiene información detallada sobre la oferta de un paquete específico utilizando su SKU. Devuelve los detalles completos de la oferta, incluyendo precios, cantidad de datos, validez e información de las redes.","parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"created_at":{"type":"string"},"updated_at":{"type":"string"},"available":{"type":"boolean"},"sku":{"type":"string"},"bundle_name_spanish":{"type":"string"},"bundle_name_english":{"type":"string"},"bundle_description_spanish":{"type":"string"},"bundle_description_english":{"type":"string"},"bundle_identifier":{"type":"string"},"bundle_iso_code":{"type":"string"},"bundle_price_mxn":{"type":"number"},"bundle_price_usd":{"type":"number"},"bundle_validity":{"type":"number"},"bundle_capacity":{"type":"number"},"unlimited":{"type":"boolean"},"unlimited_daily_use_limit":{"type":"number"},"unlimited_speed_limit":{"type":"number"},"activation_window_validity":{"type":"number"},"regional":{"type":"boolean"},"voice_allowed":{"type":"boolean"},"profile":{"type":"array","items":{"type":"string"}},"countries_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"country_iso_code":{"type":"string"},"country_max_speed":{"type":"string"},"bundle_identifier":{"type":"string"},"regions_included_english":{"type":"array","items":{"type":"string"}},"regions_included_spanish":{"type":"array","items":{"type":"string"}},"networks":{"type":"array","items":{"type":"object","properties":{"network_full_name":{"type":"string"},"network_commercial_name":{"type":"string"},"network_code":{"type":"string"},"network_max_speed":{"type":"string"}},"required":["network_full_name","network_commercial_name","network_code","network_max_speed"]}}},"required":["country_name_spanish","country_name_english","country_iso_code","country_max_speed","bundle_identifier","regions_included_english","regions_included_spanish","networks"]}},"tier_pricing":{"type":"array","items":{"type":"object","properties":{"tier":{"anyOf":[{"type":"string","enum":["starter"]},{"type":"string","enum":["bronze"]},{"type":"string","enum":["silver"]},{"type":"string","enum":["gold"]},{"type":"string","enum":["platinum"]},{"type":"string","enum":["datosdeviaje"]}]},"price_usd":{"minimum":0,"type":"number"},"price_mxn":{"minimum":0,"type":"number"}},"required":["tier","price_usd","price_mxn"]}},"current_provider":{"type":"string"},"current_provider_bundle":{"type":"string"},"provider_bundle_array":{"type":"array","items":{"type":"string"}},"suggested_countries_not_included":{"type":"array","items":{"type":"object","properties":{"country_name_spanish":{"type":"string"},"country_name_english":{"type":"string"},"bundle_iso_code":{"type":"string"},"bundle_identifier":{"type":"string"}},"required":["country_name_spanish","country_name_english","bundle_iso_code","bundle_identifier"]}},"optimized":{"type":"boolean"},"other_params":{"type":"object","properties":{}}},"required":["created_at","updated_at","available","sku","bundle_name_spanish","bundle_name_english","bundle_description_spanish","bundle_description_english","bundle_identifier","bundle_iso_code","bundle_price_mxn","bundle_price_usd","bundle_validity","bundle_capacity","unlimited","unlimited_daily_use_limit","unlimited_speed_limit","activation_window_validity","regional","voice_allowed","profile","countries_included"]}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/catalog/compatibility":{"get":{"summary":"Obtener dispositivos compatibles con eSIM","tags":["Device Compatibility"],"description":"Devuelve una lista de dispositivos compatibles con eSIM agrupados po marca, con listados bilingües de teléfonos (español e inglés).","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"brands":{"type":"array","items":{"type":"object","properties":{"brand_id":{"type":"number"},"brand":{"type":"string"},"phones":{"type":"array","items":{"type":"array","items":{"type":"string"}}},"phones_english":{"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["brand_id","brand","phones","phones_english"]}}},"required":["brands"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/analytics/sales":{"get":{"summary":"Obtener analíticas de ventas","tags":["Analytics"],"description":"Returns sales analytics including costs, oders, eSIMs, and bundles broken down by granularity (day/week/month).","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"start_date","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"end_date","required":false},{"schema":{"anyOf":[{"type":"string","enum":["day"]},{"type":"string","enum":["week"]},{"type":"string","enum":["month"]},{"type":"string","enum":["quarter"]},{"type":"string","enum":["year"]}]},"in":"query","name":"granularity","required":false},{"schema":{"type":"string"},"in":"query","name":"mock","required":false},{"schema":{"type":"string"},"in":"query","name":"time_zone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"date_start":{"type":"string"},"date_end":{"type":"string"},"granularity":{"type":"string"},"total_cost":{"type":"number"},"cost_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}},"total_orders":{"type":"number"},"orders_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}},"avg_cost_per_order_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"average":{"type":"number"},"total":{"type":"number"},"count":{"type":"number"}},"required":["date","average","total","count"]}},"avg_cost_per_esim_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"average":{"type":"number"},"total":{"type":"number"},"count":{"type":"number"}},"required":["date","average","total","count"]}},"avg_cost_per_bundle_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"average":{"type":"number"},"total":{"type":"number"},"count":{"type":"number"}},"required":["date","average","total","count"]}},"total_esims":{"type":"number"},"esims_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}},"total_bundles":{"type":"number"},"bundles_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}},"esim_topups_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}},"esim_new_by_granularity":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"amount":{"type":"number"}},"required":["date","amount"]}}},"required":["date_start","date_end","granularity","total_cost","cost_by_granularity","total_orders","orders_by_granularity","avg_cost_per_order_by_granularity","avg_cost_per_esim_by_granularity","avg_cost_per_bundle_by_granularity","total_esims","esims_by_granularity","total_bundles","bundles_by_granularity","esim_topups_by_granularity","esim_new_by_granularity"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/analytics/top-sales":{"get":{"summary":"Obtener analíticas de los más vendidos","tags":["Analytics"],"description":"Returns top perfoming SKUs, destinations, and package variants by volume and revenue.","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"start_date","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"end_date","required":false},{"schema":{"type":"string"},"in":"query","name":"mock","required":false},{"schema":{"type":"string"},"in":"query","name":"time_zone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"date_start":{"type":"string"},"date_end":{"type":"string"},"total_countries":{"type":"number"},"top_skus":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string"},"name_english":{"type":"string"},"name_spanish":{"type":"string"},"description_english":{"type":"string"},"description_spanish":{"type":"string"},"amount":{"type":"number"},"percentage":{"type":"number"}},"required":["sku","name_english","name_spanish","description_english","description_spanish","amount","percentage"]}},"top_destinations":{"type":"array","items":{"type":"object","properties":{"country_iso":{"type":"string"},"country_name_english":{"type":"string"},"country_name_spanish":{"type":"string"},"amount":{"type":"number"},"percentage":{"type":"number"}},"required":["country_iso","country_name_english","country_name_spanish","amount","percentage"]}},"top_package_variants":{"type":"array","items":{"type":"object","properties":{"variant_english":{"type":"string"},"variant_spanish":{"type":"string"},"amount":{"type":"number"},"percentage":{"type":"number"}},"required":["variant_english","variant_spanish","amount","percentage"]}}},"required":["date_start","date_end","total_countries","top_skus","top_destinations","top_package_variants"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/analytics/usage":{"get":{"summary":"Obtener analíticas de uso","tags":["Analytics"],"description":"Devuelve datos de consumo por día y país, incluyendo consumo total, desglose de GB vs ilimitado y conteo de usuarios.","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"start_date","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"end_date","required":false},{"schema":{"anyOf":[{"type":"string","enum":["day"]},{"type":"string","enum":["week"]},{"type":"string","enum":["month"]},{"type":"string","enum":["quarter"]},{"type":"string","enum":["year"]}]},"in":"query","name":"granularity","required":false},{"schema":{"type":"string"},"in":"query","name":"mock","required":false},{"schema":{"type":"string"},"in":"query","name":"time_zone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"date_start":{"type":"string"},"date_end":{"type":"string"},"total_packages_with_consumption":{"type":"number"},"consumption_by_day_by_country":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"amount_gb":{"type":"number"},"amount_unlimited":{"type":"number"},"users_on_gb":{"type":"number"},"users_on_unlimited":{"type":"number"},"average_consumption_per_user_gb":{"type":"number"},"average_consumption_per_user_unlimited":{"type":"number"},"date":{"type":"string"},"country_iso":{"type":"string"},"country_name_english":{"type":"string"},"country_name_spanish":{"type":"string"}},"required":["amount","amount_gb","amount_unlimited","users_on_gb","users_on_unlimited","average_consumption_per_user_gb","average_consumption_per_user_unlimited","date","country_iso","country_name_english","country_name_spanish"]}},"average_consumption_per_package_variant":{"type":"array","items":{"type":"object","properties":{"variant_english":{"type":"string"},"variant_spanish":{"type":"string"},"amount_gb":{"type":"number"},"amount_of_packages":{"type":"number"},"average_consumption":{"type":"number"}},"required":["variant_english","variant_spanish","amount_gb","amount_of_packages","average_consumption"]}},"unique_users_by_granularity":{"type":"object","properties":{"by_week":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"country_iso":{"type":"string"},"unique_users_gb":{"type":"number"},"unique_users_unlimited":{"type":"number"}},"required":["period","country_iso","unique_users_gb","unique_users_unlimited"]}},"by_month":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"country_iso":{"type":"string"},"unique_users_gb":{"type":"number"},"unique_users_unlimited":{"type":"number"}},"required":["period","country_iso","unique_users_gb","unique_users_unlimited"]}},"by_quarter":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"country_iso":{"type":"string"},"unique_users_gb":{"type":"number"},"unique_users_unlimited":{"type":"number"}},"required":["period","country_iso","unique_users_gb","unique_users_unlimited"]}},"by_year":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"country_iso":{"type":"string"},"unique_users_gb":{"type":"number"},"unique_users_unlimited":{"type":"number"}},"required":["period","country_iso","unique_users_gb","unique_users_unlimited"]}}},"required":["by_week","by_month","by_quarter","by_year"]}},"required":["date_start","date_end","total_packages_with_consumption","consumption_by_day_by_country","average_consumption_per_package_variant","unique_users_by_granularity"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/analytics/channels":{"get":{"summary":"Obtener analíticas de rendimiento por canal y proceso","tags":["Analytics"],"description":"Returns oder count, revenue, and average oder value by sales channel and process.","parameters":[{"schema":{"format":"date","type":"string"},"in":"query","name":"start_date","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"end_date","required":false},{"schema":{"type":"string"},"in":"query","name":"mock","required":false},{"schema":{"type":"string"},"in":"query","name":"time_zone","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":true,"type":"boolean"},"data":{"type":"object","properties":{"date_start":{"type":"string"},"date_end":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"channel":{"anyOf":[{"type":"string","enum":["website"]},{"type":"string","enum":["app"]}]},"order_count":{"type":"number"},"order_count_percentage":{"type":"number"},"revenue":{"type":"number"},"revenue_percentage":{"type":"number"},"avg_order_value":{"type":"number"}},"required":["channel","order_count","order_count_percentage","revenue","revenue_percentage","avg_order_value"]}},"processes":{"type":"array","items":{"type":"object","properties":{"process":{"anyOf":[{"type":"string","enum":["flight_booking"]},{"type":"string","enum":["app_post_booking"]},{"type":"string","enum":["website_post_booking"]},{"type":"string","enum":["doters"]},{"type":"string","enum":["dedicated_page"]},{"type":"string","enum":["other"]}]},"order_count":{"type":"number"},"order_count_percentage":{"type":"number"},"revenue":{"type":"number"},"revenue_percentage":{"type":"number"},"avg_order_value":{"type":"number"}},"required":["process","order_count","order_count_percentage","revenue","revenue_percentage","avg_order_value"]}}},"required":["date_start","date_end","channels","processes"]}},"required":["success","data"]}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}},"/analytics/export":{"get":{"summary":"Exportar reporte de analíticas","tags":["Analytics"],"description":"Downloads analytics data as CSV o JSON. Specify the repot type and fomat.","parameters":[{"schema":{"anyOf":[{"type":"string","enum":["sales"]},{"type":"string","enum":["usage"]},{"type":"string","enum":["channels"]},{"type":"string","enum":["top-sales"]}]},"in":"query","name":"report","required":true},{"schema":{"anyOf":[{"type":"string","enum":["csv"]},{"type":"string","enum":["json"]}]},"in":"query","name":"format","required":true},{"schema":{"format":"date","type":"string"},"in":"query","name":"start_date","required":false},{"schema":{"format":"date","type":"string"},"in":"query","name":"end_date","required":false},{"schema":{"type":"string"},"in":"query","name":"mock","required":false}],"responses":{"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"default":false,"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}}}}}},"servers":[{"url":"https://api.fulldatos.app","description":"Servidor de producción"},{"url":"http://localhost:8080","description":"Servidor de desarrollo"}],"tags":[{"name":"Catalog","description":"Todas las ofertas de paquetes disponibles para la compra de eSIMs. Incluye búsqueda por país, región y una lista de destinos disponibles."},{"name":"Orders","description":"Endpoints de gestión de pedidos para crear y recuperar pedidos - requiere autenticación"},{"name":"eSIMs","description":"Endpoints de estado y gestión de eSIM - requiere autenticación"},{"name":"Bundles","description":"Endpoints de gestión de paquetes comprados - requiere autenticación"},{"name":"Users","description":"Endpoints de gestión de usuarios - requiere autenticación"},{"name":"Refunds","description":"Endpoints de gestión de reembolsos para procesar devoluciones de paquetes - requiere autenticación"},{"name":"Credits","description":"Endpoints de balance de créditos e historial de transacciones - requiere autenticación"},{"name":"Device Compatibility","description":"Listas de dispositivos compatibles con eSIM agrupados por marca, con listados bilingües"},{"name":"Status","description":"Endpoints de estado del sistema y redes"},{"name":"Tickets","description":"Endpoints de tickets de soporte para enviar y dar seguimiento a incidencias - requiere autenticación"},{"name":"Analytics","description":"Analíticas de ventas, activación, uso, geografía y canales - requiere autenticación"},{"name":"Sandbox","description":"Entorno de pruebas con aprovisionamiento simulado de eSIM - requiere organización con sandbox habilitado"},{"name":"Additional - Orders","description":"Pedidos de eSIM con seguimiento de canal de ventas para integración de socios"},{"name":"Additional - Webhooks","description":"Configuración de webhooks salientes para entrega de eventos en tiempo real a sistemas asociados"}]}