> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snek.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Vesting by redeemer

> Unspent vestings for a redeemer PKH

Returns all **unspent** vestings whose redeemer matches the given **verification key hash** (query parameter).

**Auth:** Public

POST requests must include **`Content-Type: application/json`**. There is no JSON body schema in the endpoint — send an empty body or `{}` if your client requires a body.

## Query parameters

<ParamField query="redeemerVkhs" type="string" required>
  A single **56-character hex** redeemer payment key hash (name is plural for historical reasons; one value).
</ParamField>

## Response

<ResponseField name="vestings" type="object[]">
  List of vesting rows.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Vesting identifier (domain id / UTxO-derived).
    </ResponseField>

    <ResponseField name="lockUntil" type="string">
      Lock deadline (stringified; Unix-style value from domain).
    </ResponseField>

    <ResponseField name="redeemerVkh" type="string">
      Redeemer verification key hash (hex).
    </ResponseField>

    <ResponseField name="tokenPolicyId" type="string">
      Minting policy id for the locked token.
    </ResponseField>

    <ResponseField name="tokenAssetName" type="string">
      Hex-encoded asset name for the locked token.
    </ResponseField>

    <ResponseField name="totalLocked" type="string">
      Total locked amount (string).
    </ResponseField>

    <ResponseField name="vestingOwnerAddress" type="string">
      Raw address string associated with the vesting output.
    </ResponseField>

    <ResponseField name="spent" type="boolean">
      Whether the vesting UTxO has been spent (should be `false` for rows returned as unspent).
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url "https://token-vesting.snek.fun/v1/vesting/get-by-redeemer?redeemerVkhs=e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62" \
    --header "Content-Type: application/json" \
    --data '{}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "vestings": [
      {
        "id": "abc123:0",
        "lockUntil": "1778390035864",
        "redeemerVkh": "e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62df682e62",
        "tokenPolicyId": "fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b",
        "tokenAssetName": "44415645",
        "totalLocked": "19525508",
        "vestingOwnerAddress": "addr1q9...",
        "spent": false
      }
    ]
  }
  ```
</ResponseExample>