---
title: "Get blockchain recipient"
method: GET
path: "/v1/blockchain_recipients/{blockchain_recipient_token}"
tags: ["Blockchain Recipient"]
---

# Get blockchain recipient

`GET /v1/blockchain_recipients/{blockchain_recipient_token}`

## Request

- Base URL: `https://sandbox.lithic.com`
- URL: `https://sandbox.lithic.com/v1/blockchain_recipients/{blockchain_recipient_token}`
- Auth: API key in header `Authorization`

Get a blockchain recipient by token

Use this to poll the `verification_state` after registering an address: a recipient cannot receive
a payout until screening completes and moves it out of `PENDING`

## Path parameters

- `blockchain_recipient_token` string, uuid, required

## Response `200`

OK

- BlockchainRecipient
  - `token` string, uuid, required: A globally unique identifier for this blockchain recipient
  - `chain` string, required: The blockchain network that the address belongs to
  - `address_tag` string, nullable, required: An optional tag or memo used by some chains to identify the destination of a transfer within a shared address
  - `external_id` string, nullable, required: The identifier the recipient is registered under with the payment provider
  - `name` string, nullable, required: The nickname for this blockchain recipient
  - `owner` string, required: Legal name of the business or individual who owns the blockchain address
  - `owner_type` 'INDIVIDUAL' | 'BUSINESS', required
  - `account_token` string, uuid, nullable, required: The financial account the blockchain recipient belongs to, or null when the recipient is registered against the program rather than a financial account
  - `program_id` string, uuid, required: Globally unique identifier for the program the blockchain recipient is associated with
  - `created` string, date-time, required: An ISO 8601 string representing when this blockchain recipient was created
  - `updated` string, date-time, required: An ISO 8601 string representing when this blockchain recipient was last updated
  - `state` 'ENABLED' | 'CLOSED' | 'PAUSED', required
  - `verification_state` 'PENDING' | 'ENABLED' | 'FAILED_VERIFICATION' | 'INSUFFICIENT_FUNDS', required

## Other responses

- `400`: A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401`: | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `404`: The specified resource was not found.
- `429`: Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

## Changes

- **2026-09-10** `4b7bfee1643c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lithic-com/apis/lithic-developer-api/changes/v1/blockchain_recipients/:blockchain_recipient_token/get.md)

---

[API](https://skmtc.dev/lithic-com/apis/lithic-developer-api.md) - [All operations](https://skmtc.dev/lithic-com/apis/lithic-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lithic-com/apis/lithic-developer-api/revisions/17d2fbc28992?raw)