New Porting Process API Changes

Upload numbers (choose one of the following):

1. POST https://api.thinq.com/inbound/port-in/upload/text

   Body (post request body as application/json)

"properties": {

"dids": { "type": "array", "items": { "type":

"string" }, "example": ["9198002000"] }

},

EXAMPLE (in body of request):

{

"dids": ["1","2","3","4"]

}

The above endpoint takes a list of DIDs sent as an array in a POST - application/json body and creates a port with those numbers.

2. POST https://api.thinq.com/inbound/port-in/upload/file

    Body (post request body as multipart/formdata)

"properties": {

"file": { "type": "object" }

},

This file needs to be a CSV formatted as either of the below examples and sent in the body with the key file as a

binary file.

1,2,3,4

OR

1

2

3

4

The above endpoint takes a file and creates a port with those numbers

3. Both endpoints above respond with a key orderIds which is an array of orders created from your port. The reason why you would get

multiple orderIds back is that the port in splits orders by carrier. If you have some numbers which go to one carrier and some numberswhich go to another carrier, those orders will be split.

orderIds: { type: 'array', items: { type: 'number' }, example: [1,

2] },

Choose carrier (has been removed from the flow for API only customers)

Previously, you had to choose which carrier your port was going to. This is being handled internally in the first endpoint, so you SKIP using

POST https://api.thinq.com/account/:account_id/origination/did/upload/:portin_process_id/do/choose_carrier/:carrier_id

Get Port In Pricing Information

- Generate costs and get port in details to use in confirm:

GET https://api.thinq.com/account/:account_id/port-in/:portin_process_id/upload/dids

- This endpoint is a replacement for this endpoint - https://apidocs.thinq.com/#18e69776-98f3-4224-a0b4-a5035e8babad

Confirm Port In

- Send confirmation details, request FOC date, and confirm port submission

POST https://api.thinq.com/account/:account_id/port-in/:portin_process_id/confirm

- This endpoint is a replacement for this endpoint - https://apidocs.thinq.com/#08df60f5-e5bc-4e5e-89bf-eea0da3b0ecf

Get confirmation details for single port

- Get information about a single endpoint

GET https://api.thinq.com/account/:account_id/port-in/:portin_process_id/tracking

- This is a replacement for this endpoint - https://apidocs.thinq.com/#f8258037-d2b3-49cc-aaff-10f9c6a91be0

Misc endpoints

- Upload LOA or Bill as file for toll free port

POST /account/:account_id/port-in/:portin_process_id/upload/files/:type where type is loa or bill

- This is a replacement for this endpoint - https://apidocs.thinq.com/#7e7ffc7b-c44d-48bb-a8ee-4de197130553

- Add internal note for your port

POST /account/:account_id/port-in/:portin_process_id/tag

NOTES:

The only main change to the process is the first endpoint and well as the structure/declaration of the endpoint URLs. The endpoints which are replacements for existing URLs (as denoted by a thinQ API documentation link) behave exactly the same as they did. inbound/port-in/upload/text or inbound/port-in/upload/text does both the upload and “choose carrier” steps. Additionally, the first endpoint can return multiple order IDs. This means you will have to complete the remaining steps for each order ID returned.