# Retrieve Deposit Logs

Fetches logs of all deposits made to your Deposit link, including transaction details, value in fiat currency, and the status of each deposit. This endpoint is essential for tracking incoming payments and ensuring they are correctly processed and reconciled in your system.

**Method:** `GET`

**Path:** ```
https://api.blockbee.io/deposit/logs/
```

---

## Parameters

### Query Parameters

- **`apikey`** (`string`) (required): API Key provided by BlockBee's [Dashboard](https://dash.blockbee.io/). Unsure how to get yours? [Check this tutorial](https://support.blockbee.io/support/solutions/articles/204000013926-how-to-generate-a-new-api-key).
**Note:** The API key can also be sent as a header named `apikey`.

- **`token`** (`string`) (required) - Example: `fG78jtx96ugjtu0eIbeLmFB9z0feJf9N`: The `payment_id` provided upon requesting the deposit link.

---

## Returns

Returns a list of deposit transactions made to your account.

- **`status`** (`string`): Status of the request. Should be success if the request didn't fail.

- **`deposits`** (`object[]`): Array of objects
  - **`txid`** (`string`): The transaction ID of the deposit.
  - **`value`** (`string`): The amount deposited in cryptocurrency.
  - **`value_fiat`** (`string`): The equivalent fiat value of the deposited amount.
  - **`coin`** (`string`): The type of cryptocurrency used for the deposit.
  - **`pending`** (`boolean`): Indicates if the deposit is still pending.
  - **`logo`** (`string`): URL to the logo of the cryptocurrency used.
  - **`timestamp`** (`string`): The timestamp when the deposit was made.

- **`total_deposited`** (`string`): The total amount deposited.

- **`currency`** (`string`): The fiat currency used for the value_fiat field.

- **`notifications`** (`object[]`): Notifications sent regarding deposit processing.
  - **`request_url`** (`string`): The URL to which the notification request was sent.
  - **`payload`** (`object`): Details of the notification sent.
  - **`payment_url`** (`string`): The URL for the hosted checkout page where the user can complete the payment.
  - **`redirect_url`** (`string`): URL where your customers will be redirected to after successfully completing the payment.
  - **`value`** (`string`): Value of the order.
  - **`success_token`** (`string`): A unique token that is passed to your `redirect_url` to verify the payment's authenticity on your end.
  - **`currency`** (`string`): The FIAT currency of the `value`.
  - **`is_paid`** (`integer`): `1` if the payment is paid.
  - **`paid_amount`** (`string`): The amount paid by the user.
  - **`paid_coin`** (`string`): The cryptocurrency the user paid with.
  - **`exchange_rate`** (`string`): The exchange rate applied to the payment.
  - **`txid`** (`string`): The transaction ID of the payment.
  - **`address`** (`string`): The address that received the payment.
  - **`status`** (`string`): Status of the payment.
  - **`response`** (`string`): The server's response to the notification request.
  - **`response_status`** (`string`): The HTTP status code of the response received.
  - **`pending`** (`boolean`): Indicates whether the notification is still pending.
  - **`timestamp`** (`string`): The timestamp when the notification was sent.




## Example Response

```json
{
  "status": "success",
  "logs": [
    {
      "address_in": "14PqCsA7KMgseZMPwg6mJy754MtQkrgszu",
      "address_out": "1H6ZZpRmMnrw8ytepV3BYwMjYYnEkWDqVP",
      "value_coin": "0.00100000",
      "value_forwarded_coin": "0.00099000",
      "value_usd": "107.99",
      "callback_url": "https://example.com/your_callback?invoice_id=123",
      "confirmations": 3,
      "txid_in": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6",
      "txid_out": "z6y5x4w3v2u1t0s9r8q7p6o5n4m3l2k1j0i9h8g7f6e5d4c3b2a1",
      "timestamp": "2024-01-15 10:30:45",
      "pending": 0,
      "fee": "0.00001000",
      "fee_usd": "1.08",
      "priority": "default",
      "value_coin_convert": "{\"USD\":\"107.99\",\"EUR\":\"98.45\"}",
      "value_forwarded_coin_convert": "{\"USD\":\"106.91\",\"EUR\":\"97.47\"}"
    }
  ]
}
```