---
title: "POST /address/used"
method: POST
path: "/address/used"
---

# POST /address/used

`POST /address/used`

Ordered lexicographically (order is not maintained)
Note: this endpoint only returns addresses that are in a block. Use another tool to see mempool information

## Request body

- AddressUsedRequest
  - `relationFilter` number, double — Filter which uses of the address are considered relevant for the query. This is a bitmask, so you can combine multiple options ex: `RelationFilterType.Input & RelationFilterType.Output` Note: relations only apply to credentials and not to full bech32 addresses
  - `addresses` Address[], required
  - `untilBlock` string, required — block hash - inclusive
  - `after` object — Omitting "after" means you query starting from the genesis block Note: the reason you have to specify both a tx hash AND a block hash in the "after" for pagination is because this is the only way to make sure your pagination doesn't get affected by rollbacks ex: a rollback could cause a tx to be removed from one block and appear in a totally different block Specifying the block hash as well allows making sure you're paginating on the right tx in the right block
    - `tx` string, required — tx hash
    - `block` string, required — block hash

## Response `200`

- AddressUsedResponse
  - `addresses` Address[], required

## Other responses

- `400`
- `428`

## Changes

- **2022-05-10** `f39bef51175a` — 5 breaking, 1 warning, 6 info
  - added the new required request property `allOf[#/components/schemas/Pagination]/untilBlock`
  - removed `#/components/schemas/CredentialHex, #/components/schemas/Bech32FullAddress, #/components/schemas/Bech32Credential, #/components/schemas/Base58Address` from the `allOf[subschema #1]/addresses/items/` request property `anyOf` list
  - the `allOf[#/components/schemas/Pagination]/` request property type changed from no type to `object`
  - the `allOf[subschema #1]/addresses/items/` request property type changed from no type to `string`
  - …8 more

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