> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt > Use this file to discover all available pages before exploring further. # List transactions in a user's watchlist > Retrieves transactions in the authenticated user's watchlist. ## OpenAPI ````yaml /openapi-specs/pro-api-v11.yaml get /v2/transactions/watchlist openapi: 3.0.0 info: contact: email: info@blockscout.com title: Blockscout version: 11.0.3 servers: - url: http://localhost/api variables: {} security: [] tags: - name: blocks - name: transactions - name: addresses - name: internal-transactions - name: tokens - name: token-transfers - name: smart-contracts - name: config - name: main-page - name: search - name: stats - name: csv-export - name: account-abstraction - name: withdrawals - name: advanced-filters - name: arbitrum - name: legacy - name: optimism - name: mud - name: celo - name: scroll - name: zilliqa paths: /v2/transactions/watchlist: get: tags: - transactions summary: List transactions in a user's watchlist description: Retrieves transactions in the authenticated user's watchlist. operationId: BlockScoutWeb.API.V2.TransactionController.watchlist_transactions parameters: - description: API key for rate limiting or for sensitive endpoints in: query name: apikey required: false schema: type: string x-struct: null x-validate: null - description: Secret key for getting access to restricted resources in: query name: key required: false schema: type: string x-struct: null x-validate: null - description: Block number for paging in: query name: block_number required: false schema: minimum: 0 type: integer x-struct: null x-validate: null - description: Item index for paging in: query name: index required: false schema: type: integer x-struct: null x-validate: null - description: Number of items returned per page in: query name: items_count required: false schema: maximum: 50 minimum: 1 type: integer x-struct: null x-validate: null responses: '200': content: application/json: schema: additionalProperties: false nullable: false properties: items: items: $ref: '#/components/schemas/TransactionResponse' nullable: false type: array x-struct: null x-validate: null next_page_params: example: block_number: 23617990 index: 128 items_count: 50 nullable: true type: object x-struct: null x-validate: null required: - items - next_page_params type: object x-struct: null x-validate: null description: Watchlist transactions. '403': content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' description: Forbidden '422': content: application/json: schema: $ref: '#/components/schemas/JsonErrorResponse' description: Unprocessable Entity callbacks: {} components: schemas: TransactionResponse: additionalProperties: false description: Transaction response properties: has_error_in_internal_transactions: nullable: true type: boolean x-struct: null x-validate: null block_number: nullable: true type: integer x-struct: null x-validate: null exchange_rate: $ref: '#/components/schemas/FloatStringNullable' transaction_types: items: enum: - coin_transfer - contract_call - contract_creation - rootstock_bridge - rootstock_remasc - token_creation - token_transfer - blob_transaction - set_code_transaction type: string x-struct: null x-validate: null type: array x-struct: null x-validate: null historic_exchange_rate: $ref: '#/components/schemas/FloatStringNullable' nonce: minimum: 0 nullable: false type: integer x-struct: null x-validate: null timestamp: $ref: '#/components/schemas/TimestampNullable' base_fee_per_gas: $ref: '#/components/schemas/IntegerStringNullable' token_transfers: items: $ref: '#/components/schemas/TokenTransfer' nullable: true type: array x-struct: null x-validate: null fhe_operations_count: description: >- Number of FHE (Fully Homomorphic Encryption) operations in the transaction nullable: false type: integer x-struct: null x-validate: null decoded_input: allOf: - $ref: '#/components/schemas/DecodedInput' nullable: true x-struct: null x-validate: null gas_price: $ref: '#/components/schemas/IntegerStringNullable' gas_limit: $ref: '#/components/schemas/IntegerString' arbitrum: additionalProperties: false nullable: false properties: batch_data_container: nullable: true type: string x-struct: null x-validate: null batch_number: nullable: true type: integer x-struct: null x-validate: null commitment_transaction: additionalProperties: false nullable: false properties: hash: $ref: '#/components/schemas/FullHashNullable' status: enum: - unfinalized - finalized nullable: true type: string x-struct: null x-validate: null timestamp: $ref: '#/components/schemas/TimestampNullable' required: - hash - timestamp - status type: object x-struct: null x-validate: null confirmation_transaction: additionalProperties: false nullable: false properties: hash: $ref: '#/components/schemas/FullHashNullable' status: enum: - unfinalized - finalized nullable: true type: string x-struct: null x-validate: null timestamp: $ref: '#/components/schemas/TimestampNullable' required: - hash - timestamp - status type: object x-struct: null x-validate: null contains_message: enum: - incoming - outcoming nullable: true type: string x-struct: null x-validate: null gas_used_for_l1: $ref: '#/components/schemas/IntegerString' gas_used_for_l2: $ref: '#/components/schemas/IntegerString' message_related_info: additionalProperties: false nullable: false properties: associated_l1_transaction_hash: $ref: '#/components/schemas/FullHashNullable' message_id: nullable: false type: integer x-struct: null x-validate: null message_status: enum: - Syncing with base layer - Relayed - Settlement pending - Waiting for confirmation - Ready for relay nullable: false type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null network_fee: $ref: '#/components/schemas/IntegerString' poster_fee: $ref: '#/components/schemas/IntegerString' status: enum: - Confirmed on base - Sent to base - Sealed on rollup - Processed on rollup nullable: false type: string x-struct: null x-validate: null required: - gas_used_for_l1 - gas_used_for_l2 - poster_fee - network_fee type: object x-struct: null x-validate: null fee: $ref: '#/components/schemas/Fee' method: $ref: '#/components/schemas/MethodNameNullable' authorization_list: items: $ref: '#/components/schemas/SignedAuthorization' nullable: true type: array x-struct: null x-validate: null to: $ref: '#/components/schemas/Address' status: enum: - ok - error nullable: true type: string x-struct: null x-validate: null gas_used: $ref: '#/components/schemas/IntegerStringNullable' from: $ref: '#/components/schemas/Address' value: $ref: '#/components/schemas/IntegerString' created_contract: allOf: - $ref: '#/components/schemas/Address' nullable: true x-struct: null x-validate: null transaction_tag: description: Transaction tag set in My Account example: personal nullable: true type: string x-struct: null x-validate: null max_priority_fee_per_gas: $ref: '#/components/schemas/IntegerStringNullable' position: minimum: 0 nullable: true type: integer x-struct: null x-validate: null confirmations: minimum: 0 type: integer x-struct: null x-validate: null token_transfers_overflow: nullable: true type: boolean x-struct: null x-validate: null type: nullable: true type: integer x-struct: null x-validate: null transaction_burnt_fee: $ref: '#/components/schemas/IntegerStringNullable' confirmation_duration: description: >- Array of time intervals in milliseconds. Can be empty [] (no info), single value [interval] (means that the transaction was confirmed within {interval} milliseconds), or two values [short_interval, long_interval] (means that the transaction's confirmation took from {short_interval} to {long_interval} milliseconds) example: - 1000 - 2000 items: description: Duration in milliseconds minimum: 0 type: integer x-struct: null x-validate: null maxItems: 2 type: array x-struct: null x-validate: null revert_reason: nullable: true oneOf: - $ref: '#/components/schemas/DecodedInput' - additionalProperties: false nullable: false properties: raw: anyOf: - $ref: '#/components/schemas/HexString' - type: string x-struct: null x-validate: null nullable: true x-struct: null x-validate: null required: - raw type: object x-struct: null x-validate: null x-struct: null x-validate: null max_fee_per_gas: $ref: '#/components/schemas/IntegerStringNullable' hash: $ref: '#/components/schemas/FullHash' result: anyOf: - enum: - pending - awaiting_internal_transactions - success - dropped/replaced type: string x-struct: null x-validate: null - description: Error message example: out of gas type: string x-struct: null x-validate: null nullable: false x-struct: null x-validate: null is_pending_update: nullable: true type: boolean x-struct: null x-validate: null raw_input: $ref: '#/components/schemas/HexString' priority_fee: $ref: '#/components/schemas/IntegerStringNullable' required: - hash - result - status - block_number - timestamp - from - to - created_contract - confirmations - confirmation_duration - value - fee - gas_price - type - gas_used - gas_limit - max_fee_per_gas - max_priority_fee_per_gas - base_fee_per_gas - priority_fee - transaction_burnt_fee - nonce - position - revert_reason - raw_input - decoded_input - token_transfers - token_transfers_overflow - exchange_rate - historic_exchange_rate - method - transaction_types - transaction_tag - has_error_in_internal_transactions - authorization_list - is_pending_update - fhe_operations_count title: TransactionResponse type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Transaction x-validate: null ForbiddenResponse: description: Response returned when the user is forbidden to access the resource properties: message: description: >- Error message indicating the user is forbidden to access the resource example: Unverified email type: string x-struct: null x-validate: null title: ForbiddenResponse type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.ErrorResponses.ForbiddenResponse x-validate: null JsonErrorResponse: properties: errors: items: properties: detail: example: null value where string expected type: string x-struct: null x-validate: null source: properties: pointer: example: /data/attributes/petName type: string x-struct: null x-validate: null required: - pointer type: object x-struct: null x-validate: null title: example: Invalid value type: string x-struct: null x-validate: null required: - title - source - detail type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - errors title: JsonErrorResponse type: object x-struct: Elixir.OpenApiSpex.JsonErrorResponse x-validate: null FloatStringNullable: nullable: true pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$ title: FloatStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FloatStringNullable x-validate: null TimestampNullable: format: date-time nullable: true title: TimestampNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.TimestampNullable x-validate: null IntegerStringNullable: nullable: true pattern: ^-?([1-9][0-9]*|0)$ title: IntegerStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringNullable x-validate: null TokenTransfer: additionalProperties: false properties: block_hash: $ref: '#/components/schemas/FullHash' block_number: nullable: false type: integer x-struct: null x-validate: null from: $ref: '#/components/schemas/Address' log_index: nullable: false type: integer x-struct: null x-validate: null method: $ref: '#/components/schemas/MethodNameNullable' timestamp: $ref: '#/components/schemas/TimestampNullable' to: $ref: '#/components/schemas/Address' token: $ref: '#/components/schemas/Token' token_type: $ref: '#/components/schemas/Type' total: anyOf: - $ref: '#/components/schemas/TotalERC721' - $ref: '#/components/schemas/TotalERC1155' - $ref: '#/components/schemas/TotalERC7984' - $ref: '#/components/schemas/Total' nullable: true x-struct: null x-validate: null transaction_hash: $ref: '#/components/schemas/FullHash' type: enum: - token_burning - token_minting - token_spawning - token_transfer type: string x-struct: null x-validate: null required: - transaction_hash - from - to - total - token - type - timestamp - method - block_hash - block_number - log_index - token_type title: TokenTransfer type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer x-validate: null DecodedInput: additionalProperties: false nullable: false properties: method_call: nullable: true type: string x-struct: null x-validate: null method_id: nullable: true type: string x-struct: null x-validate: null parameters: items: additionalProperties: false nullable: false properties: name: nullable: false type: string x-struct: null x-validate: null type: nullable: false type: string x-struct: null x-validate: null value: anyOf: - type: object x-struct: null x-validate: null - items: anyOf: - type: object x-struct: null x-validate: null - items: type: string x-struct: null x-validate: null type: array x-struct: null x-validate: null - type: string x-struct: null x-validate: null x-struct: null x-validate: null type: array x-struct: null x-validate: null - type: string x-struct: null x-validate: null nullable: false x-struct: null x-validate: null type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - method_id - method_call - parameters title: DecodedInput type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.DecodedInput x-validate: null IntegerString: nullable: false pattern: ^-?([1-9][0-9]*|0)$ title: IntegerString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerString x-validate: null FullHashNullable: nullable: true pattern: ^0x([A-Fa-f0-9]{64})$ title: FullHashNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FullHashNullable x-validate: null Fee: additionalProperties: false properties: type: enum: - maximum - actual type: string x-struct: null x-validate: null value: $ref: '#/components/schemas/IntegerStringNullable' required: - type - value title: Fee type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Transaction.Fee x-validate: null MethodNameNullable: description: Method name or hex method id example: transfer nullable: true title: MethodNameNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.MethodNameNullable x-validate: null SignedAuthorization: additionalProperties: false properties: address_hash: $ref: '#/components/schemas/AddressHash' authority: $ref: '#/components/schemas/AddressHash' chain_id: nullable: false type: integer x-struct: null x-validate: null nonce: $ref: '#/components/schemas/IntegerString' r: $ref: '#/components/schemas/IntegerString' s: $ref: '#/components/schemas/IntegerString' status: enum: - ok - invalid_chain_id - invalid_signature - invalid_nonce nullable: true type: string x-struct: null x-validate: null v: nullable: false type: integer x-struct: null x-validate: null required: - address_hash - chain_id - nonce - r - s - v - authority - status title: SignedAuthorization type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.SignedAuthorization x-validate: null Address: additionalProperties: false description: Address properties: ens_domain_name: description: ENS domain name associated with the address nullable: true type: string x-struct: null x-validate: null hash: $ref: '#/components/schemas/AddressHash' implementations: description: Implementations linked with the contract items: $ref: '#/components/schemas/Implementation' type: array x-struct: null x-validate: null is_contract: description: Has address contract code? nullable: true type: boolean x-struct: null x-validate: null is_scam: description: Has address scam badge? nullable: false type: boolean x-struct: null x-validate: null is_verified: description: Has address associated source code? nullable: true type: boolean x-struct: null x-validate: null metadata: allOf: - $ref: '#/components/schemas/Metadata' nullable: true x-struct: null x-validate: null name: description: Name associated with the address nullable: true type: string x-struct: null x-validate: null private_tags: description: Private tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null proxy_type: $ref: '#/components/schemas/ProxyType' public_tags: description: Public tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null reputation: description: Reputation of the address enum: - ok - scam nullable: false type: string x-struct: null x-validate: null watchlist_names: description: Watchlist name associated with the address items: $ref: '#/components/schemas/WatchlistName' type: array x-struct: null x-validate: null required: - hash - is_contract - name - is_scam - reputation - proxy_type - implementations - is_verified - ens_domain_name - metadata title: Address type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Address x-validate: null HexString: nullable: false pattern: ^0x([A-Fa-f0-9]*)$ title: HexString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.HexString x-validate: null FullHash: nullable: false pattern: ^0x([A-Fa-f0-9]{64})$ title: FullHash type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FullHash x-validate: null Token: additionalProperties: false description: Token struct properties: address_hash: $ref: '#/components/schemas/AddressHash' bridge_type: description: Type of bridge used for this bridged token enum: - omni - amb nullable: true type: string x-struct: null x-validate: null circulating_market_cap: $ref: '#/components/schemas/FloatStringNullable' decimals: $ref: '#/components/schemas/IntegerStringNullable' exchange_rate: $ref: '#/components/schemas/FloatStringNullable' foreign_address: nullable: true pattern: ^0x([A-Fa-f0-9]{40})$ type: string x-struct: null x-validate: null holders_count: $ref: '#/components/schemas/IntegerStringNullable' icon_url: $ref: '#/components/schemas/URLNullable' name: nullable: true type: string x-struct: null x-validate: null origin_chain_id: $ref: '#/components/schemas/IntegerStringNullable' reputation: description: Reputation of the token enum: - ok - scam nullable: true type: string x-struct: null x-validate: null symbol: nullable: true type: string x-struct: null x-validate: null total_supply: $ref: '#/components/schemas/IntegerStringNullable' type: allOf: - $ref: '#/components/schemas/Type' nullable: true x-struct: null x-validate: null volume_24h: $ref: '#/components/schemas/FloatStringNullable' required: - address_hash - symbol - name - decimals - type - holders_count - exchange_rate - volume_24h - total_supply - icon_url - circulating_market_cap - reputation title: Token type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Token x-validate: null Type: enum: - ERC-20 - ERC-721 - ERC-1155 - ERC-404 - ERC-7984 title: Type type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Token.Type x-validate: null TotalERC721: additionalProperties: false properties: token_id: $ref: '#/components/schemas/IntegerStringNullable' token_instance: allOf: - $ref: '#/components/schemas/TokenInstance' nullable: true x-struct: null x-validate: null required: - token_id - token_instance title: TotalERC721 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC721 x-validate: null TotalERC1155: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' token_id: $ref: '#/components/schemas/IntegerStringNullable' token_instance: allOf: - $ref: '#/components/schemas/TokenInstance' nullable: true x-struct: null x-validate: null value: $ref: '#/components/schemas/IntegerStringNullable' required: - token_id - value - decimals - token_instance title: TotalERC1155 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC1155 x-validate: null TotalERC7984: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' value: $ref: '#/components/schemas/IntegerStringNullable' required: - value - decimals title: TotalERC7984 type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.TotalERC7984 x-validate: null Total: additionalProperties: false properties: decimals: $ref: '#/components/schemas/IntegerStringNullable' value: $ref: '#/components/schemas/IntegerStringNullable' required: - value - decimals title: Total type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenTransfer.Total x-validate: null AddressHash: nullable: false pattern: ^0x([A-Fa-f0-9]{40})$ title: AddressHash type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHash x-validate: null Implementation: additionalProperties: false description: Proxy smart contract implementation properties: address_hash: $ref: '#/components/schemas/AddressHash' name: nullable: true type: string x-struct: null x-validate: null required: - address_hash - name title: Implementation type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Implementation x-validate: null Metadata: additionalProperties: false description: Metadata struct properties: tags: description: Metadata tags linked with the address items: $ref: '#/components/schemas/MetadataTag' type: array x-struct: null x-validate: null required: - tags title: Metadata type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.Metadata x-validate: null Tag: additionalProperties: false description: Address tag struct properties: address_hash: $ref: '#/components/schemas/AddressHash' display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - address_hash - display_name - label title: Tag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Tag x-validate: null ProxyType: enum: - eip1167 - eip1967 - eip1822 - eip1967_oz - eip1967_beacon - master_copy - basic_implementation - basic_get_implementation - comptroller - eip2535 - clone_with_immutable_arguments - eip7702 - resolved_delegate_proxy - erc7760 nullable: true title: ProxyType type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.ProxyType x-validate: null WatchlistName: additionalProperties: false description: Watchlist name struct properties: display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - display_name - label title: WatchlistName type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.WatchlistName x-validate: null URLNullable: example: https://example.com format: uri nullable: true title: URLNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.URLNullable x-validate: null TokenInstance: additionalProperties: false nullable: false properties: animation_url: $ref: '#/components/schemas/URLNullable' external_app_url: $ref: '#/components/schemas/URLNullable' id: $ref: '#/components/schemas/IntegerString' image_url: $ref: '#/components/schemas/URLNullable' is_unique: nullable: true type: boolean x-struct: null x-validate: null media_type: description: Mime type of the media in media_url example: image/png nullable: true type: string x-struct: null x-validate: null media_url: $ref: '#/components/schemas/URLNullable' metadata: example: description: Test image: https://example.com/image.png name: Test nullable: true type: object x-struct: null x-validate: null owner: allOf: - $ref: '#/components/schemas/Address' nullable: true x-struct: null x-validate: null thumbnails: nullable: true properties: 250x250: format: uri type: string x-struct: null x-validate: null 500x500: format: uri type: string x-struct: null x-validate: null 60x60: format: uri type: string x-struct: null x-validate: null original: format: uri type: string x-struct: null x-validate: null required: - original type: object x-struct: null x-validate: null token: allOf: - $ref: '#/components/schemas/Token' nullable: true x-struct: null x-validate: null token_type: allOf: - $ref: '#/components/schemas/Type' nullable: true x-struct: null x-validate: null value: $ref: '#/components/schemas/IntegerStringNullable' required: - id - metadata - owner - token - external_app_url - animation_url - image_url - is_unique - thumbnails - media_type - media_url title: TokenInstance type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.TokenInstance x-validate: null MetadataTag: additionalProperties: false description: Metadata tag struct properties: meta: nullable: false type: object x-struct: null x-validate: null name: nullable: false type: string x-struct: null x-validate: null ordinal: nullable: false type: integer x-struct: null x-validate: null slug: nullable: false type: string x-struct: null x-validate: null tagType: nullable: false type: string x-struct: null x-validate: null required: - slug - name - tagType - ordinal - meta title: MetadataTag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.MetadataTag x-validate: null ````