---
updatedAt: 2026-05-20T06:40:06.000Z
---

Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Get Deposit Records

Retrieves deposit records filtered by either a withdrawal address or a validator public key (exactly one must be provided).

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "version": "1.0.0",
    "title": "Staking Reporting API",
    "description": "### Protocols \nThe following protocols are currently supported:\n* Cardano\n* Cosmos\n* Ethereum\n* NEAR\n* Polkadot\n* Polygon \n* Solana \n",
    "contact": {
      "name": "Blockdaemon",
      "email": "support@blockdaemon.com",
      "url": "https://blockdaemon.com"
    },
    "x-logo": {
      "url": "logo.png"
    }
  },
  "servers": [
    {
      "url": "https://svc.blockdaemon.com/reporting/staking",
      "description": "Production server"
    }
  ],
  "security": [
    {
      "apiKeyAuthHeader": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v2/ethereum/{network}/deposits": {
      "get": {
        "summary": "Get Deposit Records",
        "description": "Retrieves deposit records filtered by either a withdrawal address or a validator public key (exactly one must be provided).",
        "tags": [
          "Ethereum Staking Reporting"
        ],
        "operationId": "getDeposits",
        "parameters": [
          {
            "in": "path",
            "name": "network",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/Network"
            }
          },
          {
            "in": "query",
            "name": "withdrawalAddress",
            "required": false,
            "description": "Ethereum withdrawal address",
            "example": "0xa554965fcd0d9493313e2eafa27eef5b058336f4",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "pubkey",
            "required": false,
            "description": "Validator BLS public key",
            "example": "0x8b2aa338c6dc383c80ce538e23113c124558b9634881223a7f35a5bb2806a23ba6cc62e9b120ecbe955905a87e8a7499",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List of deposit records",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ErrorResponse"
                  }
                },
                "example": [
                  {
                    "pubKey": "0xacb9365157fd0d035f36ecb82e58642cb72c850903660d130508e8e8a946b4b5905bec81c7a44f12e901901b5c63aed2",
                    "amount": 18112749083033600,
                    "blockNumber": 17880249,
                    "withdrawalCredentials": "0x010000000000000000000000252152a38b9a8d16f08b78574664f7d3f32e3de1",
                    "signature": "0x996f60e29acc6177e380bc9a49a6c9152ee3b1b327d16dd8dd0d130a191ae89cd01bbef5f639fd7643e3ec2197555ead1702b0ee6339f7623e40b2fdad02c562ba3b59de5807790cb7c0e9592ec6a877372f237d818e9ef5902a5470c892a9c3",
                    "index": 11079150851959292000,
                    "txHash": "0x71307ae3d29a57097fd3455e916ed5f596a188046926eb589522fc436dcd4942",
                    "timestamp": 1691619215,
                    "depositProvider": "0x0194512e77d798E4871973d9cB9D7DDFC0fFd801",
                    "blockHash": "0xd7f2532a20bcfdbdb2b079b866e7c35cb81e135353f3de1f280571aa50b8a8f0",
                    "withdrawalAddress": "0x252152A38b9A8D16f08B78574664F7D3f32e3De1",
                    "validatorType": "0x01"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKeyAuthHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Opaque",
        "description": "[Legacy Auth] Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "properties": {
          "timestamp": {
            "description": "The timestamp of the error in ISO-8601 format",
            "type": "string"
          },
          "path": {
            "description": "The path called when the error occurred",
            "type": "string",
            "example": "/v2/solana/mainnet/delegator"
          },
          "status": {
            "description": "The http status code",
            "type": "number",
            "example": 400
          },
          "error": {
            "description": "A useful description of the error that occurred",
            "type": "string",
            "example": "[endTime should be in unix epoch seconds]"
          }
        }
      },
      "Network": {
        "description": "Network",
        "type": "string",
        "default": "mainnet",
        "enum": [
          "mainnet",
          "holesky",
          "hoodi"
        ]
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "go",
      "javascript",
      "python",
      "node"
    ],
    "explorer-enabled": false
  }
}
```