Request a PAC for a UK MSISDN

Discover how to provide to your subscriber their PAC

To authorize your subscriber to port their MSISDN to another network operator, you must provide them with their PAC. This PAC will allow the termination of your subscriber without any other action from you.

This guide shows you how to proceed and request a PAC for your subscriber.

Endpoints

Below are all APIs url that you will need for this guide:

All Transatel APIs are available through our unique API gateway https://api.transatel.com

1. API Authentication

First things first, let's get your access token by following the getting started guide!

2. Request the PAC

Now that we are ready to proceed, let's get the PAC. The subscriber status must be Active or Suspended.

To do so, you must use the Connectivity management subscriber API and provide at least:

• sim-serial: SIM card serial number. It can be found in the delivery file listing all information about SIM cards you have ordered.
• codeType: the type of request code, here PAC

If your subscriber wishes to switch to another network operator without porting their MSISDN, you can provide STAC instead of PAC.

The below example shows how to get the PAC:

Copy
curl --location --request POST \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJidXNpbmVzc19lbnRpdGllcyI6WyJBbnkiXSwicHJpbmNpcGFsIjoib2NzLXN1YnNjcmlwdGlvbi1vcmRlci1tYW5hZ2VyIiwic2NvcGUiOlsiQ0FUQUxPR19QUk9EVUNUU19SRUFEX1RFQ0hOSUNBTCIsIkNBVEFMT0dfUFJPRFVDVFNfUkVBRCIsIlVTRVJfUkVBRCIsIklOVkVOVE9SWV9TVUJTQ1JJUFRJT05TX1JFQUQiXSwiZXhwIjoxNjE3MjYwNTYxLCJhdXRob3JpdGllcyI6WyJST0xFX0lOVEVSTkFMX1NZU1RFTSJdLCJqdGkiOiJmOTYwNTFmNS05ZmQzLTQxMDEtYjNkZC0xZjY2Y2Q2MWUzZjIiLCJjbGllbnRfaWQiOiJvY3Mtc3Vic2NyaXB0aW9uLW9yZGVyLW1hbmFnZXIifQ.KBTlltd459_4kPV0O3OfsBTFGBtoqRxG65o_NohK1U7IuJAvIjAa8Fj4Qon1ptFrrTR5M2o8l0f9Dl0D7r0Us6Ej6OsVlFXfQKUiXwVytNUTP7POB6l56Svc5CaVqkXgFKyt7_8h6Ii6R_RteujtSzJSWX7zeLSeemxsxKNtHLLIS_HLyNdQyIsVCZWRfFhdPJVQId_p6B08_A54sAwhrT7qssSbtpG1nGzdqsHdFfaqJt9ABhPedatHNlwcWtCnFthrOrD2rv0Yf8OnRLnt-ZWtypr0cqm6U-brtZeBMhcxgzF4afKlJbKN3K3drPJRrRPjL8L9bf2YvzsDWxY5lA' \
    'https://api.transatel.com/connectivity-management/api/portability/uk/sim-serial/8988247076000000319/PAC/request'

Above are highlighted the main information to provide to the API:

• Authorization header: This is where you provide the previously retrieved access_token

If successful, the response returned will be as follows:

Copy
HTTP/1.1 200 OK
X-TSL-Request-Id: aecb04b7-3a6e-435b-a7bb-b4312f1d009e
Content-Type: application/json
{
  "simSerial": "8988247076000000319",
  "authorizationCode": {
    "type": "PAC",
    "code": "ONE007628"
  },
  "expirationDate": "2023-04-29"
}

A successful response returns a HTTP/1.1 200 OK, meaning that a PAC has been generated successfully.

The response will contain the following main information:

• code: PAC associated to the MSISDN of your subscriber.
• expirationDate: Date until which the PAC is still valid. Your end user and their recipient operator must use it before the date.

At this step, your subscriber is able to provider the PAC to their recipient operator to initiate a portability request.

Please note that the MVNO is responsible for its compliance with regulations, including Ofcom mobile switching. In the case of an end-user switching code request, the MVNO must ensure the sending of the PAC / STAC and switching information by text message. This text message can be sent by using our SMS A2P API. Please find further detailed information by following this link.

3. Portability related events

In order to be notified when the port out of your subscriber has been validated or completed, you may create a webhook and subscribe to dedicated events.

Please check the connectivity management events page, to discover those events.

What to do next?

Learn more about our Connectivity management API by checking the overview documentation and API reference

• Overview
• API references