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

# Get Entity

## Overview

When the `simplified=true` query parameter is passed, the response returns a streamlined version of the entity data with only essential fields. This reduces payload size and improves performance for use cases that don't require full entity details.

## Example Request

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://h3-api-gateway.dev.h3aven.com/v1/entities/{id}?simplified=true" \
    --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```
</RequestExample>

## Response Examples

The response structure depends on whether the entity has configured view permissions. Here are both variants:

<CodeGroup>
  ```json Simple Response theme={null}
  {
    "label": "Employee",
    "params": [
      {
        "id": "param-1",
        "name": "firstName",
        "type": "TEXT",
        "isRequired": true
      },
      {
        "id": "param-2",
        "name": "lastName",
        "type": "TEXT",
        "isRequired": true
      },
      {
        "id": "param-3",
        "name": "email",
        "type": "EMAIL",
      }
    ]
  }
  ```

  ```json Response with View Permissions theme={null}
  {
    "label": "Employee",
    "viewPermission": [
      "HR",
      "MANAGER"
    ],
    "params": [
      {
        "id": "param-1",
        "name": "firstName",
        "type": "TEXT",
        "isRequired": true,
      },
      {
        "id": "param-2",
        "name": "lastName",
        "type": "TEXT",
        "isRequired": true,
      },
      {
        "id": "param-3",
        "name": "email",
        "type": "EMAIL",
        "isRequired": false,
      },
      {
        "id": "param-4",
        "name": "salary",
        "type": "CURRENCY",
        "isRequired": false,
      }
    ]
  }
  ```
</CodeGroup>