Complete Mobile

Use the Complete Mobile API to activate existing SIMs or new eSIMs via a TMF-aligned, RESTful interface.

1. Get access token
   
   Authenticate using an OAuth 2.0 bearer token. Use this token in the Authorization header for all subsequent requests.
    
2. Construct productOrder payload
    
   In your JSON payload, include:
    
   • your externalId,
   • requested dates,
   • relatedParty account information, and
   • an array of productOrderItem objects.

3. Define order items
    
   Populate the productOrderItem array with the building blocks for each activation. You can combine different types in a single order.

   • For each existing SIM activation, add one item:
     Create a single productOrderItem for the subscription.  Inside its product object, use a productRelationship to link to the existing SIM's serial number.
   • For each new eSIM activation, add a pair of items:
     Create two productOrderItem objects:
     • The first defines the new eSIM product.
     • The second defines the subscription service and uses a productOrderItemRelationship to link back to the ID of its corresponding eSIM item.

   To create a mixed order, add the required blocks for each activation to the array. 

4. Submit the order
   
   Send the complete JSON payload in a POST request to the /productOrder endpoint.
   
   The API returns a synchronous 202 Accepted status code if your request is valid.
   
   Note: This confirms we have received your request. The unique BT order reference is not created yet; it will be sent in the first notification.
    
5. Listen for order notifications
   
   Prepare to receive asynchronous status notifications from our system.