Ordering IMEIs

This page explains how to order IMEIs from Nordic Semiconductor's TAC ranges, using either the nRF Cloud portal or REST API endpoints.

You can order IMEIs for production devices by specifying a box ID. For development devices, you can use a box ID or submit a request for up to 10 individual devices at a time, up to 100 per team.

You can optionally include a model name for the end product containing a Nordic Semiconductor chip.

Access

You must be an admin or owner of a Pro or Enterprise team to access the IMEI Management interface and APIs.

If you do not see the IMEI Management page in the left sidebar of the nRF Cloud portal, make sure that your team has the correct plan and that you have the correct role within that team.

Device requirements

This guide applies to Nordic Semiconductor devices that are not preprogrammed with an IMEI.

Ordering IMEIs in the nRF Cloud portal

To order IMEIs:

1. Log in to the nRF Cloud portal.

2. Select IMEI Management in the left sidebar.

   A panel opens to the right.

3. Select nRF91x1: Order IMEIs.

   The Order IMEIs for nRF91x1 page opens.

4. Click Order IMEIs in the upper right corner of the page.

   A pop-up opens.

5. Select order type and provide the required information:

   • Box ID:
     • Box ID
     • Product
     • Model (optional)
   • Count:
     • Enter a number in the text box. You can also mouse over the text box and click the up and down arrows to select the desired number (up to 10 per request).
     • Product
     • Model (optional)

6. Click Order.

   The report is added to the relevant Ordered IMEIs card.

7. Click on an entry to open the result.

8. Copy and paste the ordered IMEIs, or download them as a CSV file.

Ordering IMEIs using the APIs

This section explains how to order IMEIs using the REST API.

Fetching information

The following endpoints return information about product names to which you can order IMEIs, as well as existing IMEI orders and requests:

• Use the GetProducts endpoint to list products to which you can order IMEIs.
• Use the ListImeiAllocations endpoint to list any previously ordered IMEIs, with optional filter parameters.
• Use the GetImeiAllocation endpoint to fetch details for a specific order entry.

Fetching usage and limits

Use the GetLimits endpoint to fetch details of order usage and limits.

Ordering IMEIs for production devices by box ID

Use the AllocateImeis endpoint to order IMEIs for production devices using a box ID.

Required parameters:

• scope: Scope of the IMEI order, which is PRODUCTION in this case.
• reelCode: A box ID that represents a batch of IMEI numbers.
• product: Name of the Nordic Semiconductor product.

You can also optionally include the model.

The server responds with HTTP status 200 and an IMEI report containing a list of the ordered IMEIs.

Ordering IMEIs for individual devices

Use the AllocateImeis endpoint to order IMEIs for individual devices. You can order up to 10 individual IMEIs per request, up to 100 per team.

The endpoint is the same as for ordering by box ID, and the scope depends on the parameters you specify (PRODUCTION, by box ID, or DEVELOPMENT, count).

Required parameters:

• scope: Scope of the IMEI order, which is DEVELOPMENT in this case.
• count or reelCode: Number of IMEIs to order or box ID, depending on your use case.
• product: Name of the Nordic Semiconductor product.

You can optionally include the model.

The server responds with HTTP status 200 and an IMEI report containing a list of the ordered IMEIs.