---
title: "GetAssistanceData"
method: GET
path: "/location/agps"
tags: ["Assisted GPS"]
deprecated: true
---

# GetAssistanceData

`GET /location/agps`

> **Deprecated.**

<div class="nrf-note">
<p><b>Cloud-to-cloud — authorize with an Organization Auth Token.</b><br><code>https://api.location.nrfcloud.com/v1/organizations/{organizationSlug}/projects/{projectSlug}/location/agps</code></p>
<p><b>Device-to-cloud — authorize with a JSON Web Token.</b><br><code>https://api.location.nrfcloud.com/v1/location/agps</code></p>
</div>

<div style="background-color: #f8d7da; color: #721c24; text-align: center; border: 1px solid #f5c6cb; border-radius: .25rem; padding: .75rem 1.25rem">This endpoint has been deprecated. Please use the <a href="#tag/GNSS/operation/GetAssistanceData">GNSS GetAssistanceData endpoint</a> instead.</div>

Provides assistance data to the device. Enables a faster time-to-first-fix (TTFF) for the GPS modem. Returns the modem
parameters for the nRF91 GPS modem in a chunk. The chunk size is determined by the request Range header. See `GetFileSize` [endpoint](#operation/GetFileSize) for details.

__Basic Request__:
```sh
curl -G $API_HOST/v1/location/agps -H "Authorization: Bearer $JWT" -H "Content-Type: application/octet-stream" -H "Range: bytes=0-2200" --output agps.bin
```

__Custom Request__:
```sh
curl -G "$API_HOST/v1/location/agps" -d "types=8" -d "mcc=244" -d "mnc=91" -d "tac=4099" -d "eci=36078631" -H "Authorization: Bearer $JWT" -H "Content-Type: application/octet-stream" -H "Range: bytes=0-2200" --output agps.bin
```

__Type definitions__:
- 1 = GPS UTC
- 2 = GPS Ephemerides
- 3 = GPS Almanac
- 4 = Klobuchar Ionospheric Correction
- 5 = Nequick Ionospheric Correction
- 6 = GPS Time of Week
- 7 = GPS System Clock
- 8 = Location (lat/lon of cell)
- 9 = GPS Integrity

## Query parameters

- `requestType` 'rtLocation' | 'rtAssistance' | 'custom' — Type of data to be returned. Deprecated because the requestType is inferred from the request data.
- `customTypes` NrfGpsMessageType[]
- `types` NrfGpsMessageType[]
- `mcc` integer — Mobile Country Code. As defined in <a href="https://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.212B-2018-PDF-E.pdf" target="_blank">ITU-T E.212</a>.
- `mnc` union — Mobile Network Code. A number or string: 120 | 1 | "001" | "01" | "000". As defined in <a href="https://www.itu.int/dms_pub/itu-t/opb/sp/T-SP-E.212B-2018-PDF-E.pdf" target="_blank">ITU-T E.212</a>.
  - number, double
  - string
- `tac` integer — Tracking Area Code (TAC). Identifies a group of LTE cells in a certain region (Tracking Area). See <a href="https://www.etsi.org/deliver/etsi_ts/123000_123099/123003/17.09.00_60/ts_123003v170900p.pdf" target="_blank">ETSI TS 123 003, section 19.4.2.3</a> for more details.
- `eci` integer — E-UTRA Cell Identifier (ECI), 28 bits (20 bits eNodeB and 8 bits Cell ID). Calculated using "(eNodeB-ID * 256) + Sector-ID". Range 0 .. 268435455. See <a href="https://www.etsi.org/deliver/etsi_ts/123000_123099/123003/17.09.00_60/ts_123003v170900p.pdf" target="_blank">ETSI TS 123 003, section 19.6</a> for more details.
- `rsrp` number, double — Reference Signal Received Power. Measured in dBm. See <a href="https://www.rfwireless-world.com/Terminology/LTE-RSRP-vs-RSRQ.html" target="_blank">this page</a> for more details. Range -157..-44
- `filtered` boolean — Send this flag if you want to receive ephemeris for only satellites in view. nRF Cloud will return ephemeris for up to 16 satellites. Cell data (eci, mcc, mnc, tac) is required. Defaults to false.
- `mask` number, double — Filtered ephemeris mask angle. Only works in conjunction with the filtered flag. Controls the mask angle for which the satellites are filtered. Range 0..90 Defaults to 5

## Headers

- `range` string
- `x-custom-device-id` string — User-defined device ID, used to identify requests when using a cloud-to-cloud integration. Ignored if using a device token.

## Response `206`

Contains chunk of file defined by the Range header.

- string, byte — Chunk of the file according to the request Range header.

---

[API](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api.md) · [All operations](https://skmtc.dev/nrfcloud/apis/nrf-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nrfcloud/nrf-cloud-rest-api/revisions/c4e56e458ebf/schema)