BICS MyNumbers Number Porting API

Submit and track number portability (porting) requests - create porting requests, attach Letter of Authorization documents, update addresses, and check porting specifications and statuses. Confirmed endpoints from the OpenAPI 3.0.1 definition.

OpenAPI Specification

bics-mynumbers-porting-openapi.json Raw ↑
{
  "openapi": "3.0.1",
  "info": {
    "title": "mynumbers-porting",
    "description": "These API methods allow you to manage your porting requests.<br/> <br/> <b>Where can I find the BICS Letter of Authorization (LOA) Forms to submit porting requests?</b><br/> The BICS LOA forms are available in the Number Portability specifications on the MyNumbers Portal. You can request access to the MyNumbers portal by contacting <a href=\"mailto:mynumbers@bics.com\">mynumbers@bics.com</a>.\n<h3>What are the errors that MyNumbers API can return ?</h3>\n\n|\tCode\t|\tDescription\t|\tHttp response\t|\n|\t---\t|\t---\t|\t---\t|\n|\tE001\t|\tThe product does not exist in our system.\t|\t400\t|\n|\tE002\t|\tThe country does not exist in our system.\t|\t400\t|\n|\tE018\t|\tThe product is not yet handled via our API.\t|\t400\t|\n|\tE019\t|\tThe routing details are not valid. CRN Parameter must be filled out for the given CRN type.\t|\t400\t|\n|\tE020\t|\tPlease fill out all the mandatory attributes.\t|\t400\t|\n|\tE021\t|\tThe routing details are not valid. At least one CRN Type must be different than NA.\t|\t400\t|\n|\tE022\t|\tYour price list needs to be defined in our system. Please contact BICS.\t|\t404\t|\n|\tE030\t|\tThe service is temporarily unavailable. Please retry later or contact BICS.\t|\t500\t|\n|\tE031\t|\tThe media type in your header is invalid. Please use application/json.\t|\t400\t|\n|\tE033\t|\tThere is no address with this reference in our system. Please correct the reference.\t|\t400\t|\n|\tE035\t|\tThe length of the attribute {attribute} is too long. The maximum length for this attribute is {size} characters.\t|\t400\t|\n|\tE039\t|\tAddress is not located in the same country as the number. Please fill out the reference of address(es) located in the same country.\t|\t400\t|\n|\tE041\t|\tThere is no file in the request. Please add the file.\t|\t400\t|\n|\tE042\t|\tThe format of the file {documentName} is not valid. Allowed formats are [PDF, TIF, TIFF, JPG, JPEG, PNG, DOC, DOCX, XLS, XLSX].\t|\t400\t|\n|\tE043\t|\tThe size of the file is too large. The maximum size allowed is 10 MB.\t|\t400\t|\n|\tE046\t|\tThe length of the filename is too large. The maximum length for a filename is 240.\t|\t400\t|\n|\tE047\t|\tThe file name must contain only Latin symbols and 0-9_.\t|\t400\t|\n|\tE060\t|\tThe number specified in request does not exist.\t|\t404\t|\n|\tE061\t|\tEnum value is specified incorrectly.\t|\t400\t|\n|\tE080\t|\tList of proof of documents that you have provided does not match the list of proof of documents required. Please upload missing documents.\t|\t400\t|\n|\tE081\t|\tRequest payload is invalid.\t|\t400\t|\n|\tE085\t|\tThe number range not valid.\t|\t400\t|\n|\tE086\t|\tInvalid value for parameter {attribute}.\t|\t400\t|\n|\tE087\t|\tPorting Request can not be created for this country.\t|\t400\t|\n|\tE089\t|\tThis number is specified several times in the request. Please specify every number once only.\t|\t400\t|\n|\tE091\t|\tCancellation of porting request is not possible.\t|\t400\t|\n|\tE092\t|\tThe format of the number is not valid.\t|\t400\t|\n|\tE093\t|\tLimit is {amount} numbers per request.\t|\t400\t|\n|\tE103\t|\tYou are not allowed to edit the order. You can only edit order in status Created or Need more information.\t|\t400\t|\n|\tE119\t|\tA previous task is still pending. Please try again later.\t|\t409\t|\n|\tE120\t|\tThere is no Porting Request with this id in our system.\t|\t404\t|\n|\tE121\t|\tThe 'preferredDate' is a weekend or earlier than current date + 5 business days.\t|\t400\t|\n|\tE122\t|\tNo commercial agreement found. Please contact BICS.\t|\t400\t|\n|\tE129\t|\tPorting document reference does not belong to address.\t|\t400\t|\n|\tE130\t|\tOnly one document can be used per document type code.\t|\t400\t|\n|\tE131\t|\tThe document can not be used due to its current status.\t|\t400\t|\n|\tE132\t|\tPorting document is not relevant to porting specification.\t|\t400\t|\n|\tE133\t|\tPorting document can't be used as it is already linked to another Porting request.\t|\t400\t|\n|\tE134\t|\tThe document is already linked to this porting request.\t|\t400\t|\n|\tE135\t|\tThere is already a document with the given type associated to the porting request.\t|\t400\t|\n|\tE136\t|\tParameter documentReference can not be null.\t|\t400\t|\n|\tE137\t|\tMultiple locations when Porting restrictions are \"Address in Region\" are not allowed.\t|\t400\t|\n|\tE138\t|\tEnd User Address can not be changed as Multiple locations are not allowed when Porting restrictions are \"Address in Region\".\t|\t400\t|\n|\tE144\t|\tThe number is already in your inventory.\t|\t400\t|\n|\tE146\t|\tPorting request is not complete. Please add missing document.\t|\t400\t|\n|\tE147\t|\tCountry and Product are not available in your Pricelist. Please contact your AM.\t|\t400\t|\n",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://api.bics.com/mynumbers-porting/v1"
    },
    {
      "url": "https://sandbox.api.bics.com/mynumbers-porting/v1"
    }
  ],
  "tags": [
    {
      "name": "porting",
      "description": ""
    },
    {
      "name": "Porting Specification",
      "description": "Recive porting specification"
    }
  ],
  "paths": {
    "/portings/{portingRequestId}/documents": {
      "summary": "/portings/{portingRequestId}/documents",
      "get": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to get your documents allowed for porting request.",
        "description": "Get all the documents and their status linked to specified Porting Request.",
        "operationId": "get porting request documents",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "path",
            "description": "Unique identifier for a porting request.",
            "required": true,
            "allowEmptyValue": false,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "Unique identifier for a porting request.",
              "readOnly": false,
              "example": "10564"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of porting documents.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Document"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'documentReference': 'ac0334bc-da81-48a9-a64d-5f54474b2d35',\n    'fileName': 'proofOfAddress.pdf',\n    'size': 139769,\n    'status': 'Uploaded',\n    'created': '2018-09-07T10:10:59Z',\n    'comment': '',\n    'documentType': {\n      'code': 'POD4',\n      'description': 'Letter of Intent (LOI)'\n    }\n  }\n]\n"
              }
            },
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          },
          "404": {
            "description": "Request is not found.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          }
        }
      },
      "post": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to add documents to the porting request.",
        "description": "Update documents in the porting request. This method is used to add documents to the porting request.",
        "operationId": "Update Porting Request Documents",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "path",
            "description": "Unique identifier for a porting request.",
            "required": true,
            "allowEmptyValue": false,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "Unique identifier for a porting request.",
              "readOnly": false,
              "example": "10564"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/addPortingRequestDocumentsParams"
              },
              "examples": {},
              "example": null
            }
          }
        },
        "responses": {
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'code' : 'E033',\n    'description' : 'There is no address with this reference in our system. Please correct the reference.'\n    'timestamp' : '2022-01-11T15:16:49.53+02:00'\n  }\n]\n"
              }
            },
            "links": {}
          },
          "204": {
            "description": "Successful operation. Documents were linked sucessfully.",
            "headers": {},
            "content": {},
            "links": {}
          }
        }
      },
      "parameters": []
    },
    "/portings": {
      "summary": "/portings",
      "get": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to get a list of your porting requests.",
        "description": "Get porting request details by porting request ID , product, country, bicsReference, customerReference.",
        "operationId": "get porting requests",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "query",
            "description": "Get a porting by id,  this id is returned when you call the method for creating a porting request.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get a porting by id,  this id is returned when you call the method for creating a porting request.",
              "readOnly": false,
              "example": "123"
            }
          },
          {
            "name": "product",
            "in": "query",
            "description": "Get portings by product. Valid product codes are IBN, GMN and ITFS. IBN referring to Cloud Number, GMN referring to Global Mobile Number and ITFS referring to International Freephone Number.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get portings by product. Valid product codes are IBN, GMN and ITFS. IBN referring to Cloud Number, GMN referring to Global Mobile Number and ITFS referring to International Freephone Number.",
              "readOnly": false,
              "example": "IBN"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Get portings by country in ISO 3166-1 alpha-3 format.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get portings by country in ISO 3166-1 alpha-3 format.",
              "readOnly": false,
              "example": "GBR"
            }
          },
          {
            "name": "bicsReference",
            "in": "query",
            "description": "Get a porting by BICS reference.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get a porting by BICS reference.",
              "readOnly": false,
              "example": "SC1162160"
            }
          },
          {
            "name": "customerReference",
            "in": "query",
            "description": "Get portings by your reference.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get portings by your reference.",
              "readOnly": false,
              "example": "CustRef"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of porting requests.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/portingRequest"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'portingRequestId': '10564',\n    'bicsReference': 'SC541259',\n    'customerReference': 'your reference',\n    'product': 'IBN',\n    'country': 'FRA',\n    'estimatedVolume': '10.000 - 100.000',\n    'numbers': [\n      {\n        'numberFrom': '33184212841',\n        'numberTo': '33184212848',\n        'numberStatus': 'Partially Accepted',\n        'location': 'Paris',\n        'areaCode': '184',\n        'routing': [\n          {\n            'accessType': 'fixMobPay',\n            'accessNetwork': null,\n            'crnType': 'prefix',\n            'crnValue': '33184A',\n            'pop': 'POP FRANCE'\n          }\n        ]\n      },\n      {\n        'numberFrom': '33184213489',\n        'numberTo': null,\n        'numberStatus': 'Under verification',\n        'location': 'Paris',\n        'areaCode': '184',\n        'routing': [\n          {\n            'accessType': 'fixMobPay',\n            'accessNetwork': 'SMART',\n            'crnType': 'freetext',\n            'crnValue': '334458124588',\n            'pop': 'POP FRANCE'\n          },\n          {\n            'accessType': 'fix',\n            'accessNetwork': null,\n            'crnType': 'freetext',\n            'crnValue': '334458124588',\n            'pop': 'POP FRANCE'\n          }\n        ]\n      }\n    ],\n    'status': 'New',\n    'addresses': {\n      'endUserAddress': {\n        'reference': '1247b1ca-ffec-4576-be45-c837cdbff546'\n      },\n      'portingAddress': {\n        'reference': '365c51a4-07b8-4b04-bb6c-cbf1a1cc2205'\n      }\n    },\n    'preferredDate': '2021-10-12',\n    'comment': 'Please provide a valid LOA',\n    'additionalInfo': 'This is some Additional Info for the Porting Case',\n    'created': '2019-07-09T10:10:59Z',\n    'lastModified': '2019-07-09T10:10:59Z'\n  },\n  {\n    ...\n  }\n]\n"
              }
            },
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          }
        }
      },
      "post": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to create porting request",
        "description": "Create Porting Request for your numbers via API. The method Create Porting Request will document porting request with all necessary details so our Porting team can process it. </br>You just need to fill out in the request :Product, Country, Estimated Volume, Numbers, End user and Porting Address reference, Document reference. </br>End user address reference and Porting Address reference are response of the API when new address was successfully created. (Create Address method) </br>Document reference are the response from the API when the documents are linked to address. (Add document method) </br>Reference, Preferred date and Additional info are not mandatory fields still they can help customers for better communication with our porting team and add extra info.",
        "operationId": "Create porting request",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/createPortingRequest"
              },
              "examples": {},
              "example": null
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful operation.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/createPortingResponse"
                },
                "example": "{\n  'portingRequestId': 10564\n}\n"
              }
            },
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'code' : 'E020',\n    'description' : 'Please fill out all the mandatory attributes.'\n    'timestamp' : '2019-07-11T15:16:49.53+02:00'\n  }\n]\n"
              }
            },
            "links": {}
          }
        }
      },
      "parameters": []
    },
    "/portings/{portingRequestId}/addresses": {
      "summary": "/portings/{portingRequestId}/addresses",
      "patch": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to update End User Address and Porting Address in a porting request",
        "description": "Update address references in a porting request. Address can be updated only for Porting Request in status \"New\" or \"On Hold, More Information Required\".",
        "operationId": "Update porting request addresses",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "path",
            "description": "Unique identifier for a porting request.",
            "required": true,
            "allowEmptyValue": false,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "Unique identifier for a porting request.",
              "readOnly": false,
              "example": "10564"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/updatePortingRequestAddressesParams"
              },
              "examples": {},
              "example": null
            }
          }
        },
        "responses": {
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'code' : 'E033',\n    'description' : 'There is no address with this reference in our system. Please correct the reference.'\n    'timestamp' : '2022-01-11T15:16:49.53+02:00'\n  }\n]\n"
              }
            },
            "links": {}
          },
          "204": {
            "description": "Successful operation. Addresses were updated sucessfully.",
            "headers": {},
            "content": {},
            "links": {}
          }
        }
      },
      "parameters": []
    },
    "/portings/specifications": {
      "summary": "/portings/specifications",
      "get": {
        "tags": [
          "Porting Specification"
        ],
        "summary": "This API method returns the list of number portability specification per Product, Country.\nA portability specification item is the list of portability specification attributes related to the pair Product and Country.\nIt is possible to filter out the list of portability specifications items by product and/or country.\n",
        "description": "This API method returns the list of porting specifications. It is possible to filter out the list of porting specifications items by _Product_ and/or _Country_.",
        "operationId": "get porting specifications",
        "parameters": [
          {
            "name": "product",
            "in": "query",
            "description": "Get specifications by product. Possible values\n    - 'IBN' for Cloud Number\n    - 'ITFS' for International Freephone Number\n    - 'GMN' for Global Mobile Number\n",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get specifications by product. Possible values\n    - 'IBN' for Cloud Number\n    - 'ITFS' for International Freephone Number\n    - 'GMN' for Global Mobile Number\n",
              "readOnly": false,
              "example": "IBN"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Get specifications by country in ISO 3166-1 alpha-3 format.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Get specifications by country in ISO 3166-1 alpha-3 format.",
              "readOnly": false,
              "example": "GBR"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of porting specifications.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PortingSpecification"
                  },
                  "example": null
                },
                "example": "[\n {\n    'id': '10123',\n    'product': 'IBN',\n    'country': 'AUS',\n    'portabilityType': 'Number Portability',\n    'portingSpecifications': 'LOA:Hand signature and Company stamp are mandatory, name written in capital letters.',\n    'addressRequirement': {\n        'type': 'Required in Region',\n        'proofOfDocuments': true,\n        'documentTypesForIndividual': [\n        {\n            'code': 'POD01',\n            'description': 'Copy of Passport or End-User ID'\n        },\n        { \u2026  }\n        ],\n        'documentTypesForCompany': [\n        {\n            'code': ' POD02',\n            'description': 'Company Registration'\n        },\n        { \u2026  }\n       ]\n    },\n    'minLeadTime': 5,\n    'maxLeadTime': 10,\n    'lastModified': '2020-11-25T15:45:56+01:00'\n },\n {\n    'id': '10124',\n    'product': 'IBN',\n    'country': 'AUT',\n    \u2026\n }\n]\n"
              }
            },
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          }
        }
      },
      "parameters": []
    },
    "/portings/{portingRequestId}": {
      "summary": "/portings/{portingRequestId}",
      "get": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to get your porting request.",
        "description": "Get the details of a specific Porting Request.",
        "operationId": "get porting request by id",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "path",
            "description": "Unique identifier for a porting request.",
            "required": true,
            "allowEmptyValue": false,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "Unique identifier for a porting request.",
              "readOnly": false,
              "example": "10564"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Porting request.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/portingRequestDetails"
                },
                "example": "{\n  'portingRequestId': '10564',\n  'bicsReference': 'SC541259',\n  'customerReference': 'your reference',\n  'product': 'IBN',\n  'country': 'FRA',\n  'estimatedVolume': '10.000 - 100.000',\n  'numbers': [\n    {\n      'numberFrom': '33184212841',\n      'numberTo': '33184212848',\n      'numberStatus': 'Partially Accepted',\n      'location': 'Paris',\n      'areaCode': '184',\n      'routing': [\n        {\n          'accessType': 'fixMobPay',\n          'accessNetwork': null,\n          'crnType': 'prefix',\n          'crnValue': '33184A',\n          'pop': 'POP FRANCE'\n        }\n      ]\n    },\n    {\n      'numberFrom': '33184213489',\n      'numberTo': null,\n      'numberStatus': 'Under verification',\n      'location': 'Paris',\n      'areaCode': '184',\n      'routing': [\n        {\n          'accessType': 'fixMobPay',\n          'accessNetwork': 'SMART',\n          'crnType': 'freetext',\n          'crnValue': '334458124588',\n          'pop': 'POP FRANCE'\n        },\n        {\n          'accessType': 'fix',\n          'accessNetwork': null,\n          'crnType': 'freetext',\n          'crnValue': '334458124588',\n          'pop': 'POP FRANCE'\n        }\n      ]\n    }\n  ],\n  'status': 'New',\n  'addresses': {\n    'endUserAddress': {\n      'reference': '1247b1ca-ffec-4576-be45-c837cdbff546',\n      'status': 'Under validation'\n    },\n    'portingAddress': {\n      'reference': '365c51a4-07b8-4b04-bb6c-cbf1a1cc2205',\n      'status': 'Validated'\n    }\n  },\n  'preferredDate': '2021-10-12',\n  'comment': 'Please provide a valid LOA',\n  'additionalInfo': 'This is some Additional Info for the Porting Case',\n  'created': '2019-07-09T10:10:59Z',\n  'lastModified': '2019-07-09T10:10:59Z'\n}\n"
              }
            },
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          },
          "404": {
            "description": "Request is not found.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "examples": {},
                "example": null
              }
            },
            "links": {}
          }
        }
      },
      "delete": {
        "tags": [
          "porting"
        ],
        "summary": "This method allows you to cancel porting request",
        "description": "This method allows you to cancel a porting request. With the method get list of porting requests, you can retrieve its current status. <h3>Reference table Status > Cancellation of porting request allowed</h3> <table> <thead> <tr> <th>Status</th><th>Cancellation allowed</th> </tr> </thead> <tbody> <tr><td>New</td><td>Yes</td></tr> <tr><td>Under verification</td><td>Yes</td></tr> <tr><td>On hold, more information required</td><td>Yes</td></tr> <tr><td>Submitted to operator</td><td>Yes if option 'confirmCancel' is specified in the request</td></tr> <tr><td>Accepted</td><td class=\"text-danger\">No</td></tr> <tr><td>Partially Accepted</td><td class=\"text-danger\">No</td></tr> <tr><td>Refused</td><td class=\"text-danger\">No</td></tr> <tr><td>Completed</td><td class=\"text-danger\">No</td></tr> </tbody> </table>",
        "operationId": "cancel porting request",
        "parameters": [
          {
            "name": "portingRequestId",
            "in": "path",
            "description": "Unique identifier for a porting request.",
            "required": true,
            "allowEmptyValue": false,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string",
              "description": "Unique identifier for a porting request.",
              "readOnly": false,
              "example": "10564"
            }
          },
          {
            "name": "confirmCancel",
            "in": "query",
            "description": "Use this option to cancel the porting request when it is already in status 'Submitted to operator'. You agree that by cancelling the port request at this stage of the process you may be charged for the port request unless some special conditions apply in the respective country.",
            "required": false,
            "allowEmptyValue": false,
            "style": "form",
            "explode": true,
            "schema": {
              "type": "string",
              "description": "Use this option to cancel the porting request when it is already in status 'Submitted to operator'. You agree that by cancelling the port request at this stage of the process you may be charged for the port request unless some special conditions apply in the respective country.",
              "readOnly": false,
              "example": "true"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation.",
            "headers": {},
            "content": {},
            "links": {}
          },
          "400": {
            "description": "Bad request, An issue occurred while processing the input parameters.",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  },
                  "example": null
                },
                "example": "[\n  {\n    'code' : 'E091',\n    'description

# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bics-network/refs/heads/main/openapi/bics-mynumbers-porting-openapi.json