api/v1/orders/simswap

Method: POST https://simportal-api-staging.azurewebsites.net/api/v1/orders/simswap

Summary

Create a Sim Swap order

Request Information

URI Parameters

None.

Body Parameters

The SimSwapOrderModel contains the original SIM and the new SIM that will be swapped against

CreateSimSwapOrderModel

Name	Type	Additional information
OriginalSimId	globally unique identifier	None.
NewSimId	globally unique identifier	None.
Reason	string	None.

Request Formats

application/json, text/json

Sample:

{
  "OriginalSimId": "ebe598ec-7b69-4534-a344-55ae8911a7f4",
  "NewSimId": "7af3cac5-040b-42b7-a8c4-cc184acfe402",
  "Reason": "sample string 3"
}

application/xml, text/xml

Sample:

<CreateSimSwapOrderModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SimPortalApi.Models.Orders">
  <Reason>sample string 3</Reason>
  <NewSimId>7af3cac5-040b-42b7-a8c4-cc184acfe402</NewSimId>
  <OriginalSimId>ebe598ec-7b69-4534-a344-55ae8911a7f4</OriginalSimId>
</CreateSimSwapOrderModel>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'CreateSimSwapOrderModel'.

Response Information

Resource Description

OrderResponseModel

Name	Type	Additional information
OrderId	globally unique identifier	None.
Created	date	None.
State	OrderState	None.
OrderTimescale	string	None.

Response Formats

application/json, text/json

Sample:

{
  "OrderId": "9518d8c8-582c-4f2d-8e7d-5e65aa7bdce3",
  "Created": "2026-07-03T00:41:22.7174082+00:00",
  "State": 0,
  "OrderTimescale": "sample string 3"
}

application/xml, text/xml

Sample:

<OrderResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SimPortalApi.Models.Orders">
  <OrderTimescale>sample string 3</OrderTimescale>
</OrderResponseModel>