---
title: "Get deposit transfer lots"
method: GET
path: "/deposits/{deposit_id}/lots"
tags: ["Deposits"]
---

# Get deposit transfer lots

`GET /deposits/{deposit_id}/lots`

## Request

- Base URL: `https://api.cert.zerohash.com`
- URL: `https://api.cert.zerohash.com/deposits/{deposit_id}/lots`
- Auth: API key in header `X-SCX-API-KEY` and API key in header `X-SCX-PASSPHRASE`

Retrieves the cost-basis transfer lots recorded for a deposit.

## Path parameters

- `deposit_id` string, required

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

The transfer lots recorded for the deposit.

- TransferLotResponse
  - `message` TransferLotResponseEntity
    - `request_id` string: The idempotency key associated with the transfer lots.
    - `deposit_id` string, uuid: The deposit the transfer lots belong to. This is the `deposit_id` returned by the GET crypto deposits endpoints, which equals the `movement_id` returned by the GET deposits endpoint.
    - `status` string: Current processing status of the transfer lots as reported by the tax subsystem.
    - `participant_code` string: The participant the deposit was credited to.
    - `account_label` string: The account label under the participant.
    - `effective_datetime` string, date-time: RFC3339 timestamp marking when the transfer lots take effect. Absent when not set.
    - `lots` TransferLotEntity[]
      - `quantity` string, required: Quantity of the asset acquired in this lot, expressed in units of the deposited asset.
      - `cost_basis` string, required: Total cost basis of the lot in the reporting currency (USD), used for tax gain/loss calculations.
      - `acquisition_transaction_datetime` string, date-time: RFC3339 timestamp of when the asset in this lot was originally acquired. Optional; when omitted the deposit’s effective datetime is used.
    - `error_message` string: Human-readable error detail from the tax subsystem when the lots could not be processed. Absent on success.
    - `created_at` string, date-time: RFC3339 timestamp of when the transfer lots were first recorded.
    - `updated_at` string, date-time: RFC3339 timestamp of when the transfer lots were last updated.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: The deposit references an asset for which transfer lots are not supported (e.g. fiat).
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `47cf70ae701c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zerohash/apis/zerohash-api/changes/deposits/:deposit_id/lots/get.md)

---

[API](https://skmtc.dev/zerohash/apis/zerohash-api.md) - [All operations](https://skmtc.dev/zerohash/apis/zerohash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zerohash/apis/zerohash-api/revisions/47cf70ae701c?raw)