Provision

This call allows you to activate a sim on the network.

API Call Flow

To create a provision submission you'll need to call the Get Available Tariffs to get a list of available tariffs for the network you're provisioning on. Once you have selected a tariff you need to call Get Available BoltOns to get the BoltOns that are available for the tariff you have selected. Based on the Network and BoltOn(s) you select, you may also need to call the Get Available Public IP Groups or Get Available Static IP Groups endpoints and select a group from which the sim will recieve an IP Address. If you want to link these sims to an existing Provisioning Order then you can call Get Available Provisioning Orders, otherwise you can create a new Provisioning Order by specifying the name in the Provisioning call. Finally you should use the Tariff Id, Bolton Id(s) and optional Provisioning Order Id, Public IP Group Id, Static IP Group Id to construct the Provisioning call.

Additional commands needed for provisioning can be found on on the Provision Extras page.

Provision Submission

Request

Name	Type	Description	Restrictions
`stock`	`object` array	An array of stock corresponding to the SIMs you wish to update	At least one
`provisioningOrderNumber`	`number`	The id of the `Provisioning Order` to use	Required
`tariffNumber`	`number`	The id of the `Tariff` to use	Required
`boltOns`	`number` array	The id of the `Boltons` to use
`createNewProvisioningOrder`	`bool`	Should a new `Provisioning Order` be created?
`newProvisioningOrderName`	`string`	Name of new `Provisioning Order`	Required if createNewProvisioningOrder = true Alphanumeric characters only Max length 256 characters
`provisioningOrderNumber`	`number`	Id of the `Provisioning Order` to use	Required if createNewProvisioningOrder = false
`publicIpGroupId`	`number`	Id of the Public IP Group to use	Required if a Public Ip Group BoltOn is specified
`staticIpGroupId`	`number`	Id of the Static IP Group to use	Required if a Static Ip Group BoltOn is specified
`purchaseOrderNumber`	`string`	Comma separated values for Order 1, Order 2, etc	Maximum 5 values and 100 characters total

Stock

Name	Type	Description	Restrictions
`serialNumber`	`string`	The serial number of the sim	Required
`msisdn`	`string`	The msisdn to assign	Only provide this when the sim does not already have an MSISDN

Request (New Provisioning Order)

curl --location 'https://api.cellhire.com/api/simSubmission/Provision' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjRBMDlENTFBMDhEOEUxMTU0OTkyODFDN...' \
--data '{
  "stock": [
    {
      "serialNumber": "89441000303198729483",
      "msisdn": "07000000000"
    }
  ],
  "purchaseOrderNumber": "string",
  "tariffNumber": 100001,
  "boltOns": [
    500032,
    500051
  ],
  "createNewProvisioningOrder": true,
  "newProvisioningOrderName": "Test Order",
}

Request (Existing Provisioning Order)

curl --location 'https://api.cellhire.com/api/simSubmission/Provision' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjRBMDlENTFBMDhEOEUxMTU0OTkyODFDN...' \
--data '{
  "stock": [
    {
      "serialNumber": "89441000303198729483",
      "msisdn": "07000000000"
    }
  ],
  "purchaseOrderNumber": "string",
  "tariffNumber": 100001,
  "boltOns": [
    500032,
    500051
  ],
  "provisioningOrderNumber": 12345,
}

Successful Response

Name	Type	Description
`ticketNumber`	`guid`	Submission Id that has been created

{ "ticketNumber": "1beeb8dd-1825-4bcd-8a62-f941aacb8d15" }

Get Requests Change Provision