Scaling an IoT deployment? Join our webinar on May 28th where we dive into real-world scaling pain points and how to overcome them.

Blues Developers
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
Button IconHelp
Notehub StatusVisit our Forum
Button IconSign In
Sign In
Sign In
Docs Home
What’s New
Resources
Blog
Technical articles for developers
Newsletter
The monthly Blues developer newsletter
Terminal
Connect to a Notecard in your browser
Developer Certification
Get certified on wireless connectivity with Blues
Webinars
Listing of Blues technical webinars
Blues.comNotehub.io
Shop
Docs
API Reference
Glossary
System Notefiles
Notecard API
Introduction
card Requests
dfu Requests
env Requests
file Requests
hub Requests
note Requests
ntn Requests
ntn.gpsntn.resetntn.status
var Requests
web Requests
Notehub API
API Introduction
Authorization API
Billing Account API
Device API
Event API
Monitor API
Project API
Route API
homechevron_rightDocschevron_rightAPI Referencechevron_rightNotecard APIchevron_rightntn Requests - API Reference

ntn Requests

Use a compatible Notecard to interface with a paired Starnote device for NTN (satellite) communications.

Notecard Firmware Version:
[choose a notecard_firmware_version]
Latest (9.x)8.x LTS7.x6.x LTS5.x4.x LTS3.x2.x LTS

ntn.gps CellCell+WiFiWiFi

Determines whether a Notecard should override a paired Starnote's GPS/GNSS location with its own GPS/GNSS location. The paired Starnote uses its own GPS/GNSS location by default.

Arguments

on

boolean (optional)

When true, a Starnote will use the GPS/GNSS location from its paired Notecard, instead of its own GPS/GNSS location.

off

boolean (optional)

When true, a paired Starnote will use its own GPS/GNSS location. This is the default configuration.

{
  "req": "ntn.gps",
  "on": true
}
J *req = NoteNewRequest("ntn.gps");
JAddBoolToObject(req, "on", true);
NoteRequest(req);
req = {"req": "ntn.gps"}
req["on"] = True
rsp = card.Transaction(req)
Response Members

on

boolean

Returned and true if a Starnote will use the GPS/GNSS location from its paired Notecard.

off

boolean

Returned and true if a paired Starnote will use its own GPS/GNSS location.

Example Response
{"off":true}
More information:
  • Starnote Quickstart

ntn.reset CellCell+WiFiWiFi

Once a Notecard is connected to a Starnote device, the presence of a physical Starnote is stored in a permanent configuration that is not affected by a card.restore request. This request clears this configuration and allows you to return to testing NTN mode over cellular or Wi-Fi.

Arguments
None
{
  "req": "ntn.reset"
}
J *req = NoteNewRequest("ntn.reset");
NoteRequest(req);
req = {"req": "ntn.reset"}
rsp = card.Transaction(req)
Response Members
None: an empty object {} means success.
Example Response
{}
More information:
  • Starnote Quickstart

ntn.status CellCell+WiFiWiFi

Displays the current status of a Notecard's connection to a paired Starnote.

Arguments
None
{
  "req": "ntn.status"
}
J *req = NoteNewRequest("ntn.status");
NoteRequest(req);
req = {"req": "ntn.status"}
rsp = card.Transaction(req)
Response Members

err

string

This member is present if any errors have occurred while connecting to a paired Starnote, for example:

{"err":"no NTN module is connected {no-ntn-module}"}

status

string

Details about a Notecard's connection to a paired Starnote, for example:

{"status":"{ntn-idle}{ntn-unknown-location}"}

Example Response
{"status":"{ntn-idle}"}
More information:
  • Starnote Quickstart
note Requests var Requests
Can we improve this page? Send us feedback
© 2025 Blues Inc.
© 2025 Blues Inc.
TermsPrivacy
Notecard Disconnected
Having trouble connecting?

Try changing your USB cable as some cables do not support transferring data. If that does not solve your problem, contact us at support@blues.com and we will get you set up with another tool to communicate with the Notecard.

Advanced Usage

The help command gives more info.

Connect a Notecard
Use USB to connect and start issuing requests from the browser.
Try Notecard Simulator
Experiment with Notecard's latest firmware on a Simulator assigned to your free Notehub account.

Don't have an account? Sign up