---
title: "POST /projected-nft/range"
method: POST
path: "/projected-nft/range"
---

# POST /projected-nft/range

`POST /projected-nft/range`

Query any projected NFT. Learn more [<u>here</u>](https://github.com/dcSpark/projected-nft-whirlpool).

## Request body

- ProjectedNftRangeRequest
  - `limit` number, double
  - `slotLimits` SlotLimits
    - `to` number, double, required
    - `from` number, double, required
  - `address` string
  - `after` BlockTxPair
    - `tx` string, required — tx hash
    - `block` string, required — block hash
  - `untilBlock` string, required — block hash - inclusive

## Response `200`

- object[]
  - `txId` string, required — Transaction id of related Projected NFT event
  - `block` string, required
  - `payload` object[], required
    - `forHowLong` string, nullable, required — UNIX timestamp till which the funds can't be claimed in the Unlocking state. If the status is not Unlocking this is always null.
    - `plutusDatum` string, required — Projected NFT datum: serialized state of the Projected NFT
    - `status` 'Lock' | 'Unlocking' | 'Claim' | 'Invalid', required
    - `amount` string, required — Number of assets of `asset` type used in this Projected NFT event.
    - `assetName` string, required — Asset name that relates to Projected NFT event
    - `policyId` string, required — Asset policy id that relates to Projected NFT event
    - `previousTxOutputIndex` number, double, nullable, required — Output index of related previous Projected NFT event. Null if event has `status` Lock.
    - `previousTxHash` string, nullable, required — Transaction id of related previous Projected NFT event. E.g. you locked the NFT and get unlocking event: you will see previousTxHash = transaction hash of lock event. Null if event has `status` Lock.
    - `actionOutputIndex` number, double, nullable, required — Output index of related Projected NFT event. Null if it is claim event (No new UTxO is created).
    - `ownerAddress` string, nullable, required — Projected NFT owner address. Not null only if owned by Public Key Hash.
    - `actionSlot` number, double, required — Slot at which the transaction happened

## Other responses

- `400`
- `409`
- `422`

---

[API](https://skmtc.dev/dcspark/apis/carp.md) · [All operations](https://skmtc.dev/dcspark/apis/carp/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dcspark/carp/revisions/ab189523ed9a/schema)