> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /admin/show/shards

```
URL: http://<db.host>:<db.port>/admin/show/shards
```

Show the mapping of shards to the corresponding rank and tom.  The response
message contains list of 16384 (total number of shards in the system) Rank and
TOM numbers corresponding to each shard.

## Input Parameter Description

<ParamField body="options" type="map of string to strings">
  Optional parameters.

  The default value is an empty map ( \{} ).
</ParamField>

## Output Parameter Description

The Kinetica server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query.  Here is a description of the various fields of the wrapper:

<ResponseField name="status" type="String">
  'OK' or 'ERROR'
</ResponseField>

<ResponseField name="message" type="String">
  Empty if success or an error message
</ResponseField>

<ResponseField name="data_type" type="String">
  'admin\_show\_shards\_response' or 'none' in case of an error
</ResponseField>

<ResponseField name="data" type="String">
  Empty string
</ResponseField>

<ResponseField name="data_str" type="JSON or String">
  This embedded JSON represents the result of the /admin/show/shards endpoint:

  <Expandable title="data_str">
    <ResponseField name="version" type="long">
      Current shard array version number.
    </ResponseField>

    <ResponseField name="rank" type="array of ints">
      Array of ranks indexed by the shard number.
    </ResponseField>

    <ResponseField name="tom" type="array of ints">
      Array of toms to which the corresponding shard belongs.
    </ResponseField>

    <ResponseField name="info" type="map of string to strings">
      Additional information.
    </ResponseField>
  </Expandable>

  Empty string in case of an error.
</ResponseField>