# Introduction

# Purpose

Miyabi contains certain public and internal APIs. The public APIs are mostly used by clients (either via the ClientSDK or the CLI) to send and receive information from Miyabi. The purpose of this API documentation is to provide details of the requests and responses of each API offered by Miyabi.

# Definitions of Input Parameters

Parameter ContentType Description Limit Comment
tableName string Name of a table N/A
key ByteString ByteString used as the key for table entries N/A
height signed int32 Number that shows a block's position in the chain min=0, max=max(int32)
blockHeight signed int32 The height that consensus is currently running at min=0, max=max(int32)
startHeight signed int32 The starting height used when designating a range of blocks min=0, max=max(int32) If it is greater than the current height, an object not found error will be returned. It will be calculated by depth from the current height if it is not defined.
depth signed int32 The maximum number of blocks to be retrieved min=0, max=max(int32) The default value is 10, if it is not provided.
id (Block Id) ByteString Each block has a unique hexadecimal Id called block Id N/A
id (Transaction Id) ByteString Each transaction in the blockchain has a unique hexadecimal Id called transaction Id N/A Can be calculated through the CLI command gettransactionid using the transaction data in hex or json format
transactionRequest TransactionRequest Entity containing details about the transaction (transaction Id, transaction entries, etc.) N/A

# Swagger

The APIs use swagger for API documentation with OAS, details of the API can be found at https://{host}/swagger/index.html (e.g. Playground (opens new window)).