# firmwares — NCM API

The firmware releases available for Cradlepoint devices, one object per release. Read-only, a single list call. Use it to discover which versions exist before scheduling an upgrade, and to map a router's reported firmware_version onto a known release.

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

### GET /firmwares/

Get information about firmwares

<p>This operation gets Firmwares List.</p>

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| X-ECM-API-ID | header | string | yes | <strong>ECM API app Id</strong> |
| X-ECM-API-KEY | header | string | yes | <strong>ECM API app key</strong> |
| X-CP-API-ID | header | string | yes | <strong>Cradlepoint API app Id</strong> |
| X-CP-API-KEY | header | string | yes | <strong>Cradlepoint API access key</strong> |
| id | query | integer | no | The ID of a firmwares record |
| id__in | query | integer | no | Filter for ID contains - a comma-separated list of firmwares record IDs |
| version | query | string | no | Version of this firmware |
| version__in | query | string | no | Filter for version contains - a comma-separated list of versions |
| limit | query | integer | no | Restricts the number of records returned in a recordset to this value. Max value is 500. |
| offset | query | integer | no | Specifies where (an index) in a recordset to begin returning records. |

**Example request**

```bash
curl "https://www.cradlepointecm.com/api/v2/firmwares/" \
  -H "X-CP-API-ID: <cp-api-id>" \
  -H "X-CP-API-KEY: <cp-api-key>" \
  -H "X-ECM-API-ID: <ecm-api-id>" \
  -H "X-ECM-API-KEY: <ecm-api-key>"
```

**Response 200** — Example response.

```json
{
  "data": [
    {
      "built_at": "2013-07-02T16:34:08+00:00",
      "default_configuration": "https://www.cradlepointecm.com/api/v2/firmwares/2/default_configuration/",
      "expires_at": "2020-01-01T00:00:00+00:00",
      "hash": "516cdeaef3830f5558eb1276b4f6f573440f4082",
      "id": "2",
      "is_deprecated": true,
      "product": "https://www.cradlepointecm.com/api/v2/products/6/",
      "released_at": "2013-07-02T16:34:08+00:00",
      "resource_url": "https://www.cradlepointecm.com/api/v2/firmwares/2/",
      "uploaded_at": "2013-07-03T17:59:25.035746+00:00",
      "url": "https://d251cfg5d9gyuq.cloudfront.net/MBR1200B-2013-07-02T16%3A34%3A08.bin",
      "version": "4.3.2"
    }
  ],
  "meta": {
    "limit": 20,
    "next": null,
    "offset": 0,
    "previous": null
  }
}
```