---
title: "POST /delegation/pool"
method: POST
path: "/delegation/pool"
---

# POST /delegation/pool

`POST /delegation/pool`

Returns the list of delegations for the provided pools. The pool field in
the response will be null when the address was previously delegating to a
pool in the input, but now the delegation is moved to a pool outside the
list, or when the staking key is unregistered.

This is useful to keep track of the delegators for a particular pool.

## Request body

- DelegationForPoolRequest
  - `limit` number, double
  - `slotLimits` SlotLimits
    - `to` number, double, required
    - `from` number, double, required
  - `pools` Pool[], required
  - `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
    - `slot` number, double, required
    - `pool` string, required
    - `credential` union, required — Supported types: - Credential hex (8200581c...) - note this is not a keyhash (it contains a credential type prefix) - Bech32 full address (`addr` / `addr_test` / `stake` / `stake_test`) - Bech32 credentials ( `addr_vkh`, `script`, etc.) - this is the recommended approach - Legacy Byron format (Ae2, Dd, etc.) Note: we recommend avoiding to query base addresses history using bech32 As Cardano UTXO spendability depends only on the payment credential and not the full base address The result will also miss transactions that are only related to the payment key of the address ex: the payment key is used in a multisig Note: using two different address representations in the same query will hurt performance (ex: addr1 and addr_vkh1) This because under-the-hood this will run multiple independent SQL queries for the different formats Warning: querying reward bech32 addresses is equivalent to querying the stake credential inside it This may return more results than expected (ex: a multisig containing the staking key of the wallet)
      - string
      - string
      - string
      - string

## Other responses

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

## Changes

- **2024-03-16** `75bcd2b9384e` — 5 breaking, 2 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/credential` from the response with the `200` status
  - removed the required property `items/pool` from the response with the `200` status
  - …5 more
- **2023-12-01** `990ea2b00f2a` — 1 info
  - endpoint added
- **2022-05-10** `f39bef51175a` — 1 breaking
  - api path removed without deprecation

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