---
title: "Get logs"
method: GET
path: "/logs"
tags: ["Chain Data"]
---

# Get logs

`GET /logs`

Retrieve logs for the given transaction(s). Corresponds to the <a href="/chifra/chaindata/#chifra-logs">chifra logs</a> command line.

## Query parameters

- `transactions` string[], required
- `emitter` string[]
- `topic` string[]
- `articulate` boolean
- `chain` string
- `noHeader` boolean
- `cache` boolean
- `decache` boolean
- `fmt` string

## Response `200`

returns the requested data

- object
  - `data` union[] — Produces <a href="/data-model/other/#function">Function</a>, <a href="/data-model/chaindata/#log">Log</a>, <a href="/data-model/other/#message">Message</a> or <a href="/data-model/other/#parameter">Parameter</a> data. Corresponds to the <a href="/chifra/chaindata/#chifra-logs">chifra logs</a> command line.
    - union
      - Function — a human-readable representation of a Solidity function call or event
        - `name` string, string — the name of the interface
        - `type` string, string — the type of the interface, either 'event' or 'function'
        - `signature` string, string — the canonical signature of the interface
        - `encoding` string, string — the signature encoded with keccak
        - `inputs` Parameter[] — the input parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
        - `outputs` Parameter[] — the output parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
      - Log — log data as returned from the RPC (with slight enhancements)
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the zero-indexed position of the transaction in the block
        - `logIndex` number — the zero-indexed position of this log relative to the block
        - `timestamp` number — the timestamp of the block this log appears in
        - `date` string, datetime — the timestamp as a date (calculated)
        - `address` string, address — the smart contract that emitted this log
        - `topics` Topic[] — first topic event signature up to 3 additional index parameters may appear
        - `data` string, bytes — any remaining un-indexed parameters to the event
        - `transactionHash` string, hash — the hash of the transction
        - `blockHash` string, hash — the hash of the block
        - `articulatedLog` object — a human-readable version of the topic and data fields
        - `compressedLog` string, string — a truncated, more readable version of the articulation (calculated)
        - `isNFT` boolean — true if the log is an NFT transfer (calculated)
      - Message — used for various responses when no real data is generated
        - `msg` string, string — the message
        - `num` number — a number if needed
      - Parameter — an input or output parameter to a Solidity function or event
        - `type` string, string — the type of this parameter
        - `name` string, string — the name of this parameter
        - `strDefault` string, string — the default value of this parameter, if any
        - `indexed` boolean — `true` if this parameter is indexed
        - `internalType` string, string — for composite types, the internal type of the parameter
        - `components` Parameter[] — for composite types, the parameters making up the composite

## Other responses

- `400` — bad input parameter

## Changes

- **2025-03-27** `2f9b4968d332` — 1 info
  - added the optional property `data/items/oneOf[#/components/schemas/log]/isNFT` to the response with the `200` status
- **2024-05-23** `dc48e08fde74` — 1 warning, 1 info
  - deleted the `query` request parameter `raw`
  - removed `#/components/schemas/logFilter` from the `data/items/` response property `oneOf` list for the response status `200`
- **2024-05-03** `bd3425654b91` — 3 breaking
  - the `data/items/oneOf[#/components/schemas/log]/logIndex` response's property type/format changed from `number`/`uint64` to `number`/`lognum` for status `200`
  - the `data/items/oneOf[#/components/schemas/log]/transactionIndex` response's property type/format changed from `number`/`uint64` to `number`/`txnum` for status `200`
  - the `data/items/oneOf[#/components/schemas/message]/num` response's property type/format changed from `string`/`int` to `number`/`int64` for status `200`
- **2024-04-30** `b2da4e150982` — 1 breaking
  - added `#/components/schemas/function, #/components/schemas/message, #/components/schemas/parameter` to the `data/items/` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/logs/get.md)

---

[API](https://skmtc.dev/trueblocks/apis/trueblocks-api.md) · [All operations](https://skmtc.dev/trueblocks/apis/trueblocks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trueblocks/trueblocks-api/revisions/2a176f1485a9/schema)