transactions

Get incoming transfers

Changed on

Retrieves a paginated list of incoming transfers to a Safe, including ETH and token transfers with optional filtering by date, value, token, and trust status.

get/v1/chains/{chainId}/safes/{safeAddress}/incoming-transfers

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

chainIdstring required
Example:1

Chain ID where the Safe is deployed

safeAddressstring required

Safe contract address (0x prefixed hex string)

Query parameters

trustedboolean

Filter by trust status (true for trusted tokens, false for untrusted)

execution_date__gtestring

Filter by execution date greater than or equal to (ISO 8601 format)

execution_date__ltestring

Filter by execution date less than or equal to (ISO 8601 format)

tostring

Filter by recipient address (0x prefixed hex string)

valuestring

Filter by transfer value in wei

token_addressstring

Filter by token contract address (0x prefixed hex string for ERC-20 tokens)

cursorstring

Pagination cursor for retrieving the next set of results

Response

Paginated list of incoming transfers

countnumber nullable
nextstring nullable
previousstring nullable

Changes

  • d3a67b477ce8Revision changes
    • info

      added the required property //////// to the response with the status

  • 475b63ba0343Revision changes
    • breaking

      added to the //////// response property oneOf list for the response status