# Notecard API **URL:** https://discuss.blues.com/c/notecard-api/12.md [Latest](https://discuss.blues.com/latest.md) · [Categories](https://discuss.blues.com/categories.md) · [Tags](https://discuss.blues.com/tags.md) --- ## [About the Notecard API category](https://discuss.blues.com/t/about-the-notecard-api-category/21)
**Author:** [@bsatrom](https://discuss.blues.com/u/bsatrom)\ **Replies:** 0
This section is for questions and discussion about using the Notecard API as documented in the Notecard Guide and Complete API Reference. --- ## [Iridium NTN/Track mode](https://discuss.blues.com/t/iridium-ntn-track-mode/3629)
**Author:** [@richf](https://discuss.blues.com/u/richf)\ **Replies:** 1\ **Last updated:** [September 3, 2026, 8:29pm UTC](https://discuss.blues.com/t/iridium-ntn-track-mode/3629 "2026-09-03T20:29:02Z")
Hi, is TRACK mode allowed when using Internal (Iridium) GPS module for accessing Lat/Lon position? regards, Rich .. --- ## [Note-cpp — a type-safe C++ library for the Notecard (community project)](https://discuss.blues.com/t/note-cpp-a-type-safe-c-library-for-the-notecard-community-project/3579)
**Author:** [@mdma](https://discuss.blues.com/u/mdma)\ **Replies:** 1\ **Last updated:** [July 26, 2026, 8:00am UTC](https://discuss.blues.com/t/note-cpp-a-type-safe-c-library-for-the-notecard-community-project/3579 "2026-07-26T08:00:58Z")
Hi all :waving\_hand: I’ve been building note-cpp, a header-only C++ library for the Blues Notecard, and I’d love to share it with the community and get your feedback. The goal was a Notecard API that feels natural in m… --- ## [Underdocumented note.update 'sync' field?](https://discuss.blues.com/t/underdocumented-note-update-sync-field/3570)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 1\ **Last updated:** [June 15, 2026, 8:03pm UTC](https://discuss.blues.com/t/underdocumented-note-update-sync-field/3570 "2026-06-15T20:03:21Z")
Hi Blues, So I guess the note.update API is missing the sync field mention? I tried sending one with/without and saw from trace log that sync: wakeup: test.dbs again was advertised when using "sync": true. Can you con… --- ## [Addition of some error status codes](https://discuss.blues.com/t/addition-of-some-error-status-codes/3569)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 1\ **Last updated:** [June 15, 2026, 7:51pm UTC](https://discuss.blues.com/t/addition-of-some-error-status-codes/3569 "2026-06-15T19:51:17Z")
Hi Blues, First of all, I saw that you added per API status/error codes, that helps a lot! Now, while I was exploring my Notecard handling, I noticed that for some messages, there are errors/statuses that do not have t… --- ## [Where do I find note\_c\_hooks](https://discuss.blues.com/t/where-do-i-find-note-c-hooks/3556)
**Author:** [@rlkeith](https://discuss.blues.com/u/rlkeith)\ **Replies:** 4\ **Last updated:** [May 26, 2026, 11:56am UTC](https://discuss.blues.com/t/where-do-i-find-note-c-hooks/3556 "2026-05-26T11:56:24Z")
Hi All, I have just resurrected an old project that uses Zephyr and updated the note-c libraries. However, I can’t find updated versions of note\_c\_hooks.c and note\_c\_hooks.h. I am getting a number of errors from note\_c\_… --- ## [Startnote/Cellular "HubSync"](https://discuss.blues.com/t/startnote-cellular-hubsync/3514)
**Author:** [@richf](https://discuss.blues.com/u/richf)\ **Replies:** 2\ **Last updated:** [April 6, 2026, 2:55pm UTC](https://discuss.blues.com/t/startnote-cellular-hubsync/3514 "2026-04-06T14:55:42Z")
Hi, First thing – thanks to TJ & Rob for quick responses to recent topics. I had a question about Starnote startup .. the documentation indicates that a cellular HubSync must be issued successfully before switching to … --- ## [Refresh card.wireless info once per minute?](https://discuss.blues.com/t/refresh-card-wireless-info-once-per-minute/790)
**Author:** [@JordanAbacus](https://discuss.blues.com/u/JordanAbacus)\ **Replies:** 9\ **Last updated:** [March 26, 2026, 5:14pm UTC](https://discuss.blues.com/t/refresh-card-wireless-info-once-per-minute/790 "2026-03-26T17:14:25Z")
I want to implement a feature in our product whereby we provide near-real time information about cellular signal strength to customers during the installation process. The device is being installed in an area of a buildi… --- ## [Starnote satellite "Trace" diagnostics](https://discuss.blues.com/t/starnote-satellite-trace-diagnostics/3507)
**Author:** [@richf](https://discuss.blues.com/u/richf)\ **Replies:** 3\ **Last updated:** [March 24, 2026, 3:15pm UTC](https://discuss.blues.com/t/starnote-satellite-trace-diagnostics/3507 "2026-03-24T15:15:52Z")
Hi, Regarding “Starnote” satellite detection - I’m having issues consistently accessing satellites for a Noteadd. My location is not ideal but I can “sometimes” push a payload & have it indicate (via Notehub) the transa… --- ## [How is the "bars" field calculated in response to "card.wireless"?](https://discuss.blues.com/t/how-is-the-bars-field-calculated-in-response-to-card-wireless/3496)
**Author:** [@Renato](https://discuss.blues.com/u/Renato)\ **Replies:** 3\ **Last updated:** [March 18, 2026, 4:10pm UTC](https://discuss.blues.com/t/how-is-the-bars-field-calculated-in-response-to-card-wireless/3496 "2026-03-18T16:10:57Z")
Hi, I am interested in how the bars field is calculated in response to card.wireless request to Notecard API. I am wondering what are the thresholds and if they are correctly set for my cellular connection using Notecar… --- ## [Reusing deleted Note IDs](https://discuss.blues.com/t/reusing-deleted-note-ids/3488)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 2\ **Last updated:** [March 11, 2026, 8:17am UTC](https://discuss.blues.com/t/reusing-deleted-note-ids/3488 "2026-03-11T08:17:05Z")
Hi, for Database Notefiles, is it possible to reuse the notee IDs that have been deleted? I get {note-noexist} when checking for it, but {note-exists} when trying to add a new note but with a Note ID that has been dele… --- ## [How to check whether outbound Notefiles (data.qo) are pending](https://discuss.blues.com/t/how-to-check-whether-outbound-notefiles-data-qo-are-pending/3466)
**Author:** [@mark\_pdx](https://discuss.blues.com/u/mark_pdx)\ **Replies:** 3\ **Last updated:** [February 21, 2026, 8:46pm UTC](https://discuss.blues.com/t/how-to-check-whether-outbound-notefiles-data-qo-are-pending/3466 "2026-02-21T20:46:05Z")
Our senior in-home activity monitoring device uses the MBNAN Notecard, uploading a data packet once an hour, on the hour, around the clock. We use wall-charger power, no batteries, so we just use the continuous connectio… --- ## [Limit on message body size?](https://discuss.blues.com/t/limit-on-message-body-size/1534)
**Author:** [@rlkeith](https://discuss.blues.com/u/rlkeith)\ **Replies:** 10\ **Last updated:** [February 5, 2026, 11:46pm UTC](https://discuss.blues.com/t/limit-on-message-body-size/1534 "2026-02-05T23:46:20Z")
Hi All, I am trying to send messages to the Notecard via the serial port. It works fine when the body is 1 kB or a bit over, but the message I am trying to send is about 2,100 bytes. When I send that I get an error: { … --- ## [External GPS on cold boot](https://discuss.blues.com/t/external-gps-on-cold-boot/2045)
**Author:** [@spring](https://discuss.blues.com/u/spring)\ **Replies:** 21\ **Last updated:** [November 20, 2025, 3:20pm UTC](https://discuss.blues.com/t/external-gps-on-cold-boot/2045 "2025-11-20T15:20:48Z")
I am having trouble with the GPS on a cold boot, it works fine if I reset the processor after a cold boot. My initialisation commands are {“req”:“card.aux”,“mode”:“track”,“limit”:false,“gps”:true} {“mode”:“track”,“rate… --- ## [Limitations on templated arrays](https://discuss.blues.com/t/limitations-on-templated-arrays/3382)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 3\ **Last updated:** [November 19, 2025, 4:17pm UTC](https://discuss.blues.com/t/limitations-on-templated-arrays/3382 "2025-11-19T16:17:57Z")
Hi, Blues team Using the latest FW v9.3.1, I was wondering what I can expect from the templated arrays. I’m familiar with the fact that they are designed to store only known data types. So, given how I have an Array o… --- ## [Ntn.status request misbehaviour: keeps responding with {no-ntn-module}, but sat qo is functional](https://discuss.blues.com/t/ntn-status-request-misbehaviour-keeps-responding-with-no-ntn-module-but-sat-qo-is-functional/3351)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 3\ **Last updated:** [November 17, 2025, 7:30pm UTC](https://discuss.blues.com/t/ntn-status-request-misbehaviour-keeps-responding-with-no-ntn-module-but-sat-qo-is-functional/3351 "2025-11-17T19:30:18Z")
Greeting Blues team, I had some issues with {ntn.status} request, where I’d consistently receive {no-ntn-module} status, but the satellite communication is working just fine. I can create a file which is properly templ… --- ## [Lon, lat not included in starnote note](https://discuss.blues.com/t/lon-lat-not-included-in-starnote-note/3017)
**Author:** [@gauteh](https://discuss.blues.com/u/gauteh)\ **Replies:** 26\ **Last updated:** [November 11, 2025, 4:52pm UTC](https://discuss.blues.com/t/lon-lat-not-included-in-starnote-note/3017 "2025-11-11T16:52:59Z")
Hi, I’ve gotten starnote to work, but it doesn’t seem to send the special \_lon \_lat fields.. ? It does send payload + other fields I have. Would this happen if it doesn’t have a position? { "event": "537cd023-e287-84… --- ## [Float truncated in Transaction](https://discuss.blues.com/t/float-truncated-in-transaction/1441)
**Author:** [@szygmunt](https://discuss.blues.com/u/szygmunt)\ **Replies:** 5\ **Last updated:** [November 10, 2025, 11:42pm UTC](https://discuss.blues.com/t/float-truncated-in-transaction/1441 "2025-11-10T23:42:32Z")
Having an issue where a float timestamp is sent correctly to the card settings.db file but is truncated on the Transaction request in micropython running on an ESP32. The debug of the request in the REPL shows it correc… --- ## [Time Change not reflected in card.time request](https://discuss.blues.com/t/time-change-not-reflected-in-card-time-request/3362)
**Author:** [@scavoj](https://discuss.blues.com/u/scavoj)\ **Replies:** 3\ **Last updated:** [November 4, 2025, 9:05pm UTC](https://discuss.blues.com/t/time-change-not-reflected-in-card-time-request/3362 "2025-11-04T21:05:01Z")
I’m issuing a card.time request and am getting the response: {‘minutes’: -300, ‘lon’: -90.xxxx, ‘area’: ‘New Orleans Louisiana’, ‘zone’: ‘CDT,America/Chicago’, ‘lat’: 29.xxxx, ‘country’: ‘US’, ‘time’: 1762101832, ‘crc’:… --- ## [Note.changes max = 1 order](https://discuss.blues.com/t/note-changes-max-1-order/3350)
**Author:** [@spring](https://discuss.blues.com/u/spring)\ **Replies:** 7\ **Last updated:** [October 29, 2025, 8:00pm UTC](https://discuss.blues.com/t/note-changes-max-1-order/3350 "2025-10-29T20:00:43Z")
I am trying to write some code to limit the number of unsync’d .qo notes in the event of a long term loss of signal. My idea was to use note.changes, with max = 1 and delete = true to delete the oldest note. However the… --- ## [401 unauthorized](https://discuss.blues.com/t/401-unauthorized/3340)
**Author:** [@Mtnbiker88](https://discuss.blues.com/u/Mtnbiker88)\ **Replies:** 15\ **Last updated:** [October 29, 2025, 3:46pm UTC](https://discuss.blues.com/t/401-unauthorized/3340 "2025-10-29T15:46:27Z")
I am suddenly getting a 401 unauthorized error when trying to retrieve sensor data via a url. What is causing this? --- ## [Is it possible to have mutliple templates defined for a single Notefile](https://discuss.blues.com/t/is-it-possible-to-have-mutliple-templates-defined-for-a-single-notefile/3342)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 6\ **Last updated:** [October 23, 2025, 2:32pm UTC](https://discuss.blues.com/t/is-it-possible-to-have-mutliple-templates-defined-for-a-single-notefile/3342 "2025-10-23T14:32:42Z")
Hi, recently I was wondering if the design of Note Templates allows for multiple templates to be assigned for a given Notefile. My initial picture of note rejection mechanism on a templated notefile, was that more than… --- ## [Any documentation on all possible Notecard Status Codes for each request?](https://discuss.blues.com/t/any-documentation-on-all-possible-notecard-status-codes-for-each-request/3336)
**Author:** [@Jakov](https://discuss.blues.com/u/Jakov)\ **Replies:** 2\ **Last updated:** [October 22, 2025, 8:53am UTC](https://discuss.blues.com/t/any-documentation-on-all-possible-notecard-status-codes-for-each-request/3336 "2025-10-22T08:53:32Z")
Hello, Is there an exhaustive list of all the expected status codes: Notecard Error and Status Codes - IoT Connectivity at Blues ? I’ve noticed that you’ve noted (here: What is the list of possible return values for hu… --- ## [Error 429 too many requests](https://discuss.blues.com/t/error-429-too-many-requests/3325)
**Author:** [@Mtnbiker88](https://discuss.blues.com/u/Mtnbiker88)\ **Replies:** 4\ **Last updated:** [October 16, 2025, 4:09pm UTC](https://discuss.blues.com/t/error-429-too-many-requests/3325 "2025-10-16T16:09:47Z")
I have seen several responses to this problem but not exactly sure how to fix it. Where do I set the Limited Request Rate to 1? When I step through my code the error does not occur since I suppose I don’t exceed the 7 pe… --- ## [Send Binary Data](https://discuss.blues.com/t/send-binary-data/3303)
**Author:** [@alevillegas.cat](https://discuss.blues.com/u/alevillegas.cat)\ **Replies:** 3\ **Last updated:** [October 11, 2025, 10:52am UTC](https://discuss.blues.com/t/send-binary-data/3303 "2025-10-11T10:52:00Z")
I am trying to send binary data following the documentation, using: Calculate the MD5 checksum of the binary payload COBS-encode the binary payload. The note-c library includes a NoteBinaryEncode method to simplify… --- ## [How to read a sensor with a date range](https://discuss.blues.com/t/how-to-read-a-sensor-with-a-date-range/3301)
**Author:** [@Mtnbiker88](https://discuss.blues.com/u/Mtnbiker88)\ **Replies:** 11\ **Last updated:** [October 9, 2025, 3:02pm UTC](https://discuss.blues.com/t/how-to-read-a-sensor-with-a-date-range/3301 "2025-10-09T15:02:20Z")
I need assistance with C# code to read data from a sensor with a date range. I am able to get an AccessToken but don’t know where to go from here. Here is a sample of my code, but what is missing is the urlString to coll… --- ## [Swan wake up reason](https://discuss.blues.com/t/swan-wake-up-reason/3262)
**Author:** [@scavoj](https://discuss.blues.com/u/scavoj)\ **Replies:** 7\ **Last updated:** [October 8, 2025, 11:43pm UTC](https://discuss.blues.com/t/swan-wake-up-reason/3262 "2025-10-08T23:43:09Z")
Is there a way to get the reason for Swan wake up? If I am reading command {“req”: “card.attn”, “start”: true } correctly, it says that in the “files” response member “will include keywords to signify the occurrence … --- ## [Note-C for Raspberry Pi](https://discuss.blues.com/t/note-c-for-raspberry-pi/3295)
**Author:** [@ujur007](https://discuss.blues.com/u/ujur007)\ **Replies:** 4\ **Last updated:** [September 24, 2025, 3:55pm UTC](https://discuss.blues.com/t/note-c-for-raspberry-pi/3295 "2025-09-24T15:55:40Z")
Hello, I have two questions. First one is that weather note-c is supported for Raspberry pi? Or can it be supported with some code modification? (I got some errors trying to build on raspberry pi) I want to use binary … --- ## [DFU with no PINS](https://discuss.blues.com/t/dfu-with-no-pins/3206)
**Author:** [@chuckgiddens](https://discuss.blues.com/u/chuckgiddens)\ **Replies:** 5\ **Last updated:** [August 2, 2025, 8:23pm UTC](https://discuss.blues.com/t/dfu-with-no-pins/3206 "2025-08-02T20:23:43Z")
I want to update my ESP32 (M5Stack Dial) host firmware, but I do not have access to any of the pins. How do I use the manual update (Updating Host Firmware - IoT Connectivity at Blues) without any pins? I have it all w… --- ## [Card.motion returns status of "angled"](https://discuss.blues.com/t/card-motion-returns-status-of-angled/3197)
**Author:** [@pwarren](https://discuss.blues.com/u/pwarren)\ **Replies:** 3\ **Last updated:** [July 30, 2025, 5:13pm UTC](https://discuss.blues.com/t/card-motion-returns-status-of-angled/3197 "2025-07-30T17:13:15Z")
Hi, we’re seeing the card.motion return status of “angled” from time-to-time. Is this perhaps an undocumented status that is valid? Thank you! [Next page](https://discuss.blues.com/c/notecard-api/12.md?page=1)