Nifty API v1.0
Base URL: https://openapi.niftypm.com. Every path below already carries its own
/api/v1.0 prefix — send it verbatim.
v1.0 is the legacy surface. It stops serving requests on 1 September 2027. Start new work on the v3 API, which is camelCase and consistently paginated.
Authentication. Every operation takes Authorization: Bearer <token>.
Mint a personal access token, or run the OAuth 2.1 flow for an app that
acts on other people's behalf — see Authentication and
OAuth 2.1.
Pagination. List operations take limit (default 25 on most) and
offset. limit is capped at 1000 (a larger value is reduced to 1000)
and 0 means 100; page on with offset rather than asking for everything.
Operations that answer with hasMore set it true whenever the page came back
full, so a final page that happens to be exactly limit long also reports
true — fetch the next page to confirm you are done.
Errors. Failures answer with { "message": string, "code": number }.
code equals the HTTP status for framework errors. Exception: the OAuth
endpoints under /oauth answer with RFC 6749's { "error": string }.
Rate limits. Exceeding a limit answers 429 with a Retry-After
header giving the seconds to wait. Retry after that delay rather than
immediately.
Field naming. v1.0 is snake_case on the wire (task_group_id,
due_date); v3 is camelCase. The two are not interchangeable.
New here? Start with the quickstart.
nft_user_…) or an OAuth 2.1 access token (nft_oauth_…).