---
title: "Manage names"
method: GET
path: "/names"
tags: ["Accounts"]
---

# Manage names

`GET /names`

Query addresses or names of well-known accounts. Corresponds to the <a href="/chifra/accounts/#chifra-names">chifra names</a> command line.

## Query parameters

- `terms` string[], required
- `expand` boolean
- `matchCase` boolean
- `all` boolean
- `custom` boolean
- `prefund` boolean
- `addr` boolean
- `tags` boolean
- `clean` boolean
- `regular` boolean
- `count` boolean
- `dryRun` boolean
- `autoname` string, address
- `create` string
- `update` string
- `delete` string
- `undelete` string
- `remove` string
- `chain` string
- `noHeader` boolean
- `fmt` string

## Response `200`

returns the requested data

- object
  - `data` union[] — Produces <a href="/data-model/other/#message">Message</a> or <a href="/data-model/accounts/#name">Name</a> data. Corresponds to the <a href="/chifra/accounts/#chifra-names">chifra names</a> command line.
    - union
      - Message — used for various responses when no real data is generated
        - `msg` string, string — the message
        - `num` number — a number if needed
      - Name — an association between a human-readable name and an address used throughout TrueBlocks
        - `tags` string, string — colon separated list of tags
        - `address` string, address — the address associated with this name
        - `name` string, string — the name associated with this address (retrieved from on-chain data if available)
        - `symbol` string, string — the symbol for this address (retrieved from on-chain data if available)
        - `source` string, string — user supplied source of where this name was found (or on-chain if name is on-chain)
        - `decimals` number — number of decimals retrieved from an ERC20 smart contract, defaults to 18
        - `deleted` boolean — `true` if deleted, `false` otherwise
        - `isCustom` boolean — `true` if the address is a custom address, `false` otherwise
        - `isPrefund` boolean — `true` if the address was one of the prefund addresses, `false` otherwise
        - `isContract` boolean — `true` if the address is a smart contract, `false` otherwise
        - `isErc20` boolean — `true` if the address is an ERC20, `false` otherwise
        - `isErc721` boolean — `true` if the address is an ERC720, `false` otherwise

## Other responses

- `400` — bad input parameter

## Changes

- **2025-06-13** `f6e7f721cab9` — 1 info
  - added the new optional `query` request parameter `count`
- **2024-07-01** `dd621a60a641` — 1 warning
  - removed the optional property `data/items/oneOf[#/components/schemas/name]/petname` from the response with the `200` status
- **2024-05-03** `bd3425654b91` — 1 breaking
  - 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-29** `619c22fce24a` — 2 breaking, 13 warning
  - added `#/components/schemas/message, #/components/schemas/name` to the `data/items/` response property `oneOf` list for the response status `200`
  - the `data/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data/items/address` from the response with the `200` status
  - removed the optional property `data/items/decimals` from the response with the `200` status
  - …11 more
- **2024-04-10** `92d116712599` — 1 breaking, 1 warning, 14 info
  - the `data/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - deleted the `query` request parameter `count`
  - added the optional property `data/items/address` to the response with the `200` status
  - added the optional property `data/items/decimals` to the response with the `200` status
  - …12 more

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