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

# POST /delegation/address

`POST /delegation/address`

Returns the pool of the last delegation for this address.

Note: the tx can be in the current epoch, so the delegation may not be in
effect yet.

## Request body

- DelegationForAddressRequest
  - `until` object, required
    - `absoluteSlot` number, double, required
  - `address` 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

## Response `200`

- DelegationForAddressResponse
  - `txId` string, nullable, required
  - `pool` string, nullable, required

## Other responses

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

## Changes

- **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/address/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)