---
title: "Get topic by ID"
method: GET
path: "/api/v1/topics/{topicId}"
tags: ["topics"]
---

# Get topic by ID

`GET /api/v1/topics/{topicId}`

Returns the topic details for the given topic ID.

## Path parameters

- `topicId` string, nullable, required — Network entity ID in the format of `shard.realm.num`

## Response `200`

OK

- Topic
  - `admin_key` Key, nullable, required — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `auto_renew_account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
  - `auto_renew_period` integer, nullable, required — The amount of time to attempt to extend the topic's lifetime after expiration.
  - `created_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
  - `custom_fees` ConsensusCustomFees, required — Custom fees assessed for each message submitted to the topic
    - `created_timestamp` string — A Unix timestamp in seconds.nanoseconds format
    - `fixed_fees` FixedCustomFee[]
      - `amount` integer
      - `collector_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
      - `denominating_token_id` string, nullable — Network entity ID in the format of `shard.realm.num`
  - `deleted` boolean, nullable, required — Whether the topic is deleted or not.
  - `fee_exempt_key_list` Key[], required — Keys permitted to submit messages to the topic without paying custom fees
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `fee_schedule_key` Key, nullable, required — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `memo` string, required — The memo associated with the topic.
  - `submit_key` Key, nullable, required — The public key which controls access to various network entities.
    - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
    - `key` string
  - `timestamp` TimestampRange, required — A timestamp range an entity is valid for
    - `from` string — The inclusive from timestamp in seconds
    - `to` string, nullable — The exclusive to timestamp in seconds
  - `topic_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)