List IMSIs | emnify Documentation

import requests
url = "https://cdn.emnify.net/api/v1/imsi"
querystring = {"q":"","sort":""}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

[
  {
    "id": 17,
    "imsi": "112201234567008",
    "import_date": "2019-03-25T13:12:39.000Z",
    "status": {
      "id": 0,
      "description": "Enabled"
    },
    "imsi_pool": {
      "id": 7,
      "description": "MNO 1 Pool",
      "network_coverage_id": 2,
      "resource_provider": {
        "id": 3,
        "status_id": 0,
        "organisation_id": 4,
        "organisation_name": "MNO 1"
      }
    },
    "type": {
      "id": 0,
      "description": "Root IMSI"
    },
    "sim": {
      "id": 20,
      "iccid": "6660000000000000005",
      "production_date": null,
      "status_id": 0,
      "sim_model_id": 3,
      "customer_org": {
        "id": 11,
        "name": "Reseller 3 C5",
        "type_id": 3,
        "country_id": 14,
        "status_id": 0,
        "ext_reference": null
      },
      "issuer_org": {
        "id": 5,
        "name": "Service Provider 1",
        "type_id": 2,
        "country_id": 205,
        "status_id": 0,
        "ext_reference": null
      }
    }
  },
  {
    "id": 18,
    "imsi": "232201234567456",
    "import_date": "2019-03-27T17:16:32.000Z",
    "status": {
      "id": 0,
      "description": "Enabled"
    },
    "imsi_pool": {
      "id": 7,
      "description": "MNO 1 Pool",
      "network_coverage_id": 2,
      "resource_provider": {
        "id": 3,
        "status_id": 0,
        "organisation_id": 4,
        "organisation_name": "MNO 1"
      }
    },
    "type": {
      "id": 0,
      "description": "Root IMSI"
    },
    "sim": {
      "id": 21,
      "iccid": "6660000000000000006",
      "production_date": null,
      "status_id": 0,
      "sim_model_id": 3,
      "customer_org": {
        "id": 11,
        "name": "Reseller 3 C5",
        "type_id": 3,
        "country_id": 14,
        "status_id": 0,
        "ext_reference": null
      },
      "issuer_org": {
        "id": 5,
        "name": "Service Provider 1",
        "type_id": 2,
        "country_id": 205,
        "status_id": 0,
        "ext_reference": null
      }
    }
  }
]

Returns the list of IMSIs, filtered, sorted and paged according to query parameters.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the POST request to /api/v1/authenticate.

Query parameters

Filter parameter in <parameter>:<value> format. Multiple filters must be a comma-separated list of the following fields:

id
status
imsi
sim
import_date
type
imsi_pool

Filter parameter in `<parameter>:<value>` format. Multiple filters must be a comma-separated list of the following fields: * `id` * `status` * `imsi` * `sim` * `import_date` * `type` * `imsi_pool`

pagedoubleOptional

Current page number

per_pagedoubleOptional

Paging parameters defining the number of items per page

Sort parameter in <operator><field> format. Sort properties according to a comma-separated list from the following fields:

id
status
imsi
sim
import_date
type
imsi_pool

Sort parameter in `<operator><field>` format. Sort properties according to a comma-separated list from the following fields: * `id` * `status` * `imsi` * `sim` * `import_date` * `type` * `imsi_pool`

Response headers

Linkstring or null

URLs for navigational links used to retrieve first, previous, next and last page in a dataset

X-Count-Per-Pageinteger

The requested per_page parameter

X-Current-Pageinteger

The current page number within the current data set

X-Total-Countinteger

The total element count in the current data set

X-Total-Pagesinteger

The total page count in the current data set

X-Filterstring or null

If filtering is applied using ?q=field:criteria URL query parameters, the filter criteria is returned here

X-Sortstring or null

If sorting is applied using ?sort=sort_criteria URL query parameters, the sort criteria is returned here

Response

Successfully returned a list of IMSIs

idinteger or null

imsistring or null

import_datestring or null

statusobject or null

imsi_poolobject or null

typeobject or null

simobject or null