> ## Documentation Index
> Fetch the complete documentation index at: https://docs.renaiss.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelogs

> Renaiss API v2 release notes, listed by release date in UTC.

**Oct 29, 2026**

Track pulls and buybacks by request ID

* **Pulls.** `POST /v2/gacha/pull/request` now returns HTTP `202` with a `requestId`. The pull continues after the connection closes. Read its progress with [`GET /v2/gacha/pull/status`](https://docs.renaiss.xyz/api-reference/gacha/get-pull-status).
* **Buybacks.** `POST /v2/gacha/buyback/request` creates a separate request for each submission. [`GET /v2/gacha/buyback/status`](https://docs.renaiss.xyz/api-reference/gacha/get-buyback-status) returns `COMPLETED` or `FAILED` when it finishes.
* **Streaming pulls.** The `pull_started` event from `POST /v2/gacha/pull/stream` now includes the `requestId`.
* **Retries.** When you resend the same signed pull while its payment is still unconfirmed, the request stays in `PENDING_PAYMENT`.

**Oct 25, 2026**

Wallet activity fixes

* **Wallet activity.** Fixed errors when loading some wallet activity records and corrected addresses and identifiers in the response from [`GET /v2/users/{walletAddress}/activities`](https://docs.renaiss.xyz/api-reference/wallets/list-activities).

**Oct 23, 2026**

Wallet token filter rename and buyback bonuses

* **Token filter.** The wallet collectibles endpoint renamed `tokenId` to `tokenIds`. Sending `tokenId` now returns HTTP `400` with `WRONG_REQUEST_PARAMS`.
* **Buyback bonus details.** Draw results from `GET /v2/gacha/draw-status` and the stream’s `draws_resolved` event now include `buybackBonus`, with the value before the bonus and the bonus rate in `bonusBps`. Wallet activities, public pack pull history, and wallet collectibles in a buyback window also include this field.
* **Bonus included in payouts.** For a card with a bonus, the returned base value (`buybackBaseValueInUSD` or `buybackBaseValueInUsd`) and any `buybackTiers` amounts already include it. Offer tiers from `GET /v2/gacha/buyback/offers` also include it. Use these amounts directly. [Buyback values and bonuses](https://docs.renaiss.xyz/gacha.md#buyback-values-and-bonuses)

**Oct 22, 2026**

Filter wallet collectibles by token ID

* **Token filter.** [`GET /v2/users/{walletAddress}/collectibles`](https://docs.renaiss.xyz/api-reference/wallets/list-collectibles) added the `tokenId` filter for up to 20 IDs. Pagination totals count the matching collectibles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.