---
title: "Manage Abi files"
method: GET
path: "/abis"
tags: ["Accounts"]
---

# Manage Abi files

`GET /abis`

Fetches the ABI for a smart contract. Corresponds to the <a href="/chifra/accounts/#chifra-abis">chifra abis</a> command line.

## Query parameters

- `addrs` string[], required
- `known` boolean
- `proxyFor` string, address
- `list` boolean
- `details` boolean
- `count` boolean
- `find` string[]
- `hint` string[]
- `encode` string
- `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/#abi">Abi</a>, <a href="/data-model/other/#function">Function</a> or <a href="/data-model/other/#parameter">Parameter</a> data. Corresponds to the <a href="/chifra/accounts/#chifra-abis">chifra abis</a> command line.
    - union
      - Abi — a human-readable representation of a Solidity smart contract
        - `address` string, address — the address for the ABI
        - `name` string, string — the filename of the ABI (likely the smart contract address)
        - `path` string, string — the folder holding the abi file
        - `fileSize` number — the size of this file on disc
        - `lastModDate` string, string — the last update date of the file
        - `isKnown` boolean — true if this is the ABI for a known smart contract or protocol
        - `isEmpty` boolean — true if the ABI could not be found (and won't be looked for again)
        - `nFunctions` number — if verbose, the number of functions in the ABI
        - `nEvents` number — if verbose, the number of events in the ABI
        - `hasConstructor` boolean — if verbose and the abi has a constructor, then `true`, else `false`
        - `hasFallback` boolean — if verbose and the abi has a fallback, then `true`, else `false`
        - `functions` Function[] — the functions for this address
          - `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
      - 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
      - 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-05-30** `12600d324bf9` — 2 warning, 1 info
  - deleted the `query` request parameter `listEvents`
  - deleted the `query` request parameter `listFuncs`
  - added the new optional `query` request parameter `details`
- **2025-05-29** `4644ccb42500` — 1 warning, 2 info
  - deleted the `query` request parameter `listItems`
  - added the new optional `query` request parameter `listEvents`
  - added the new optional `query` request parameter `listFuncs`
- **2025-05-25** `2f29b5bac24c` — 1 info
  - added the new optional `query` request parameter `listItems`
- **2024-12-17** `2428f6f19a07` — 12 info
  - added the new optional `query` request parameter `count`
  - added the new optional `query` request parameter `list`
  - added the optional property `data/items/oneOf[#/components/schemas/abi]/fileSize` to the response with the `200` status
  - added the optional property `data/items/oneOf[#/components/schemas/abi]/hasConstructor` to the response with the `200` status
  - …8 more
- **2024-04-10** `92d116712599` — 13 warning
  - deleted the `query` request parameter `count`
  - deleted the `query` request parameter `details`
  - deleted the `query` request parameter `list`
  - removed the optional property `data/items/oneOf[#/components/schemas/abi]/fileSize` from the response with the `200` status
  - …9 more

[Change history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/abis/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)