# asset endpoints — NCM API

Every router and adapter in an account in one inventory list, each with its hardware series, MAC address and serial number. Read-only, a single list call. Assets link to their subscriptions and tenant, which makes this the starting point for a licensing or hardware audit; regrades is where licensing is changed.

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

### GET /api/v3/asset_endpoints

Get a response using given parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| page[after] | query | string | no | Page after (next page) |
| page[before] | query | string | no | Page before (prior page) |
| page[size] | query | integer | no | Page size (default size: 20, Max Page Size: 50) |
| filter[hardware_series] | query | string | no | Filter the page by device hardware series |
| filter[hardware_series_key] | query | string | no | Filter the page by device hardware series key |
| filter[mac_address] | query | string | no | Filter the page by device mac address |
| filter[serial_number] | query | string | no | Filter the page by device serial number |
| filter[subscription] | query | string | no | Filter the page on the subscription associated with the devices |

**Example request**

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

**Response 200** — Success! You should have a page! If it doesn't contain anything, your query filtered everything out

```json
{
  "data": [
    {
      "id": "0dSRd1RRHENamrz",
      "type": "asset_endpoints",
      "attributes": {
        "hardware_series": "AER1650",
        "hardware_series_key": "206412c4-0d40-46ee-bb43-9281cdfd0947",
        "mac_address": "0042ac915d38",
        "serial_number": "MM487415463198"
      },
      "relationships": {
        "tenants": {
          "data": {
            "id": "0015000000cJN7v",
            "type": "tenants"
          }
        },
        "subscriptions": {
          "data": [
            {
              "id": "EXT_yukXyP7pava",
              "type": "subscriptions"
            },
            {
              "id": "EXT_DOSUK8witb9",
              "type": "subscriptions"
            }
          ]
        }
      }
    },
    {
      "id": "0gRdtDDyKfvbDTj",
      "type": "asset_endpoints",
      "attributes": {
        "hardware_series": "AER1650",
        "hardware_series_key": "206412c4-0d40-46ee-bb43-9281cdfd0947",
        "mac_address": "0042f0ee883d",
        "serial_number": "MM227078041263"
      },
      "relationships": {
        "tenants": {
          "data": {
            "id": "0015000000cJN7v",
            "type": "tenants"
          }
        },
        "subscriptions": {
          "data": [
            {
              "id": "EXT_yukXyP7paaa",
              "type": "subscriptions"
            },
            {
              "id": "EXT_DOSUK8winn8",
              "type": "subscriptions"
            }
          ]
        }
      }
    }
  ],
  "included": [
    {
      "id": "EXT_yukXyP7pava",
      "type": "subscriptions",
      "attributes": {},
      "relationships": {}
    },
    {
      "id": "0015000000cJN7v",
      "type": "tenants",
      "attributes": {},
      "relationships": {}
    }
  ],
  "links": {
    "next": "https://api.cradlepointecm.com/api/v3/asset_endpoints?page[after]=MGdSZHRERHlLZnZiRFRq&page[size]=2",
    "prev": null
  },
  "meta": {
    "pagination": {
      "after": "MGdSZHRERHlLZnZiRFRq",
      "before": null
    }
  }
}
```