Skip to content
PlayDownload
Contents

Guides

Premium

The Nipto API works for Premium crews, with seven days of grace when Premium ends.

The API is part of Nipto Premium. One purchase covers the whole crew, so every member can use their own token.

Checked on each call

Premium is checked every time the API is called. As long as the crew has Premium, nothing changes.

When Premium ends

  • The API keeps answering for 7 days, so your automations do not break overnight.
  • During those days, every answer carries the header X-Nipto-Premium-Grace-Until with the end of the grace period (ISO 8601, UTC). Watch it to warn yourself.
  • After the 7 days, calls answer 403 with the code FORBIDDEN and a message saying when the grace period ended. These calls do not count toward the rate limit.
  • As soon as the crew has Premium again, the API answers normally and the grace period starts over the next time Premium ends.
After the grace period
{
  "errors": [
    {
      "message": "Premium required: this crew no longer has Premium and the 7-day grace period ended on 2026-10-16T09:12:00.000Z. Renew Premium in the Nipto app to use the API again.",
      "extensions": { "code": "FORBIDDEN" }
    }
  ]
}