---
title: "POST /asset/utxos"
method: POST
path: "/asset/utxos"
---

# POST /asset/utxos

`POST /asset/utxos`

Returns utxo entries filtered either by cip 14 fingerprint or by policy id.

This is useful to keep track of the utxo set of a particular asset.

## Request body

- AssetUtxosRequest
  - `limit` number, double
  - `slotLimits` SlotLimits
    - `to` number, double, required
    - `from` number, double, required
  - `policyIds` PolicyId[]
  - `fingerprints` Cip14Fingerprint[]
  - `after` BlockTxPair
    - `tx` string, required — tx hash
    - `block` string, required — block hash
  - `untilBlock` string, required — block hash - inclusive

## Response `200`

- object[]
  - `block` string, required
  - `txId` string, required
  - `payload` object[], required
    - `utxo` object, required
      - `index` number, double, required
      - `tx` string, required
    - `slot` number, double, required
    - `paymentCred` string, required
    - `assetName` string, required
    - `policyId` string, required
    - `cip14Fingerprint` string, required
    - `amount` string — If the utxo is created, this has the amount. It's undefined if the utxo is spent.

## Other responses

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

## Changes

- **2024-03-16** `75bcd2b9384e` — 8 breaking, 4 warning, 2 info
  - added `#/components/schemas/Pagination, subschema #1` to the request body `allOf` list
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the required property `items/assetName` from the response with the `200` status
  - removed the required property `items/cip14Fingerprint` from the response with the `200` status
  - …10 more
- **2023-12-28** `58e046e362f3` — 1 breaking, 1 warning, 5 info
  - the `items/amount` response's property type/format changed from `number`/`double` to `string`/`` for status `200`
  - removed the request property `assets`
  - added the new optional request property `fingerprints`
  - added the new optional request property `policyIds`
  - …3 more
- **2023-12-22** `054616bd0208` — 1 info
  - endpoint added
- **2022-05-10** `f39bef51175a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/dcspark/apis/carp/changes/asset/utxos/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/ab189523ed9a/schema)