# public sim mgmt assets — NCM API

Beta. SIM assets in your NetCloud Manager account that run on public carrier networks, as distinct from the SIMs inside a private cellular network. Read-only: list every asset or fetch one by ID. Pair it with public sim mgmt rate plans to see the plan attached to each SIM.

Base URL: https://api.cradlepointecm.com

### GET /api/v3/beta/public_sim_mgmt_assets

external_v3_beta_public_sim_mgmt_assets_list

Base class list method, must override this in your ViewSet as it validates query params
:param request:
:param args:
:param kwargs:
:return:

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| assigned_imei | query | string | no |  |
| carrier | query | string | no |  |
| detected_imei | query | string | no |  |
| device_status | query | string | no |  |
| filter[search] | query | string | no | The search query param performs a case insensitive substring search on a set of fields. <br> A record matches if any search field matches the search text. <br>If the search param doesn't include a field list, the server selects the fields. <br>Example:<ul><li>Search by substring: `search=substring1,substring2` </li><li>Search by field(s) and substring: `search[fieldA,fieldB]=substring1,substring2,substring3` </li><ul> |
| iccid | query | string | no |  |
| id | query | integer | no |  |
| is_licensed | query | string | no |  |
| ordering | query | string | no | Which field to use when ordering the results. |
| page[after] | query | string | no | Cursor for next page. |
| page[before] | query | string | no | Cursor for prior page. |
| page[size] | query | integer | no | Number of results to return per page. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/public_sim_mgmt_assets" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/v3/beta/public_sim_mgmt_assets/{id}

external_v3_beta_public_sim_mgmt_assets_retrieve

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | integer | yes | A unique integer value identifying this SimAsset. |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/beta/public_sim_mgmt_assets/{id}" \
  -H "Authorization: Bearer <token>"
```

**Response 200**

### GET /api/schema/

schema_retrieve

OpenApi3 schema for this API. Format can be selected via content negotiation.

- YAML: application/vnd.oai.openapi
- JSON: application/vnd.oai.openapi+json

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| format | query | string (json | yaml) | no |  |
| lang | query | string (af | ar | ar-dz | ast | az | be | bg | bn | br | bs | ca | cs | cy | da | de | dsb | el | en | en-au | en-gb | eo | es | es-ar | es-co | es-mx | es-ni | es-ve | et | eu | fa | fi | fr | fy | ga | gd | gl | he | hi | hr | hsb | hu | hy | ia | id | ig | io | is | it | ja | ka | kab | kk | km | kn | ko | ky | lb | lt | lv | mk | ml | mn | mr | my | nb | ne | nl | nn | os | pa | pl | pt | pt-br | ro | ru | sk | sl | sq | sr | sr-latn | sv | sw | ta | te | tg | th | tk | tr | tt | udm | uk | ur | uz | vi | zh-hans | zh-hant) | no |  |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/schema/"
```

**Response 200**