Skip to content
PlayDownload
Contents

Guides

Premium

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

The API is part of Nipto Premium. One purchase covers the whole tribe, 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 tribe 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 tribe 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 tribe 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" }
    }
  ]
}