---
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`

## Changes

- **2024-03-16** `75bcd2b9384e` — 14 breaking, 2 warning, 3 info
  - added `#/components/schemas/Pagination, subschema #1` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the required property `items/actionOutputIndex` from the response with the `200` status
  - removed the required property `items/actionSlot` from the response with the `200` status
  - …15 more
- **2023-12-29** `c2f3cd2081a2` — 1 breaking, 4 warning, 1 info
  - the `items/status` response's property type changed from no type to `string` for status `200`
  - added the new `Claim` enum value to the `items/status` response property for the response status `200`
  - added the new `Invalid` enum value to the `items/status` response property for the response status `200`
  - added the new `Lock` enum value to the `items/status` response property for the response status `200`
  - …2 more
- **2023-12-26** `6ed152ce8fbf` — 4 breaking, 4 info
  - the `items/amount` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `items/forHowLong` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `items/status` response's property type changed from `string` to no type for status `200`
  - removed the required property `items/asset` from the response with the `200` status
  - …4 more
- …earlier changes not shown

[Full history](https://skmtc.dev/dcspark/apis/carp/changes/projected-nft/range/post.md)

---

[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/77a569a8eb32/schema)