Skip to content

Allocating IMEIs

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

You can allocate IMEIs for production devices by specifying a reel code. For development devices, you can use a reel code or submit a request for up to 10 individual devices. You can optionally include a model name for the end product containing a Nordic Semiconductor chip. You can also specify the network operator if you want to report the allocated IMEIs at the same time.

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, check 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.

Allocating 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 View Allocations.

    The IMEI Allocations page opens.

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

    A pop-up opens.

  5. Select allocation type and scope, and provide the required information. You can optionally include the operator to report the IMEIs at the same time:

    • Production: Reel code, product, model, operator (optional).
    • Development: Enter a reel code, or 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).

  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 allocated IMEIs, or download them as a CSV file.

Allocating IMEIs using the APIs

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

Fetching information

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

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

Fetching usage and limits

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

Allocating IMEIs for production devices by reel code

Use the AllocateImeis endpoint to allocate IMEIs for production devices using a reel code.

Required parameters:

  • scope: Scope of the IMEI allocation, which is PRODUCTION in this case.
  • reelCode: A reel code that represents a batch of IMEI numbers.

Include the operator parameter if you want to report the allocated IMEIs to a certain operator's network. You can also optionally include the model.

Allocating IMEIs for development devices

Use the AllocateImeis endpoint to allocate IMEIs for development devices. You can request up to 10 individual IMEIs, or use a reel code. The endpoint is the same as for production devices, and the scope depends on the parameters you specify (PRODUCTION or DEVELOPMENT).

Required parameters:

  • scope: Scope of the IMEI allocation, which is DEVELOPMENT in this case.
  • count or reelCode: Number of IMEIs to allocate or reel code, depending on your use case.

Include the operator parameter if you want to report the allocated IMEIs to a certain operator's network. You can optionally include the model.

Retrieve the result using the GetImeiAllocation endpoint to fetch details for a specific allocation entry.

You can also specify the DEVELOPMENT scope and allocate IMEIs using a reel code.