# Get Entity by ID

This API endpoint enables fetching a single specific entity with its unique identifier.


Endpoint: GET /api/v1/entities/{id}
Version: 1.0.0
Security: x-api-key

## Path parameters:

  - `id` (string, required)
    The ID of the entity

## Query parameters:

  - `allowRedirect` (boolean)
    If set to true, the API will return a 303 redirect response if the response payload is too large. The header  and  will also include the URL to the actual resource.
    Example: true

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Example: "5e94d5b63f557b001420bbe3"

  - `data.name` (string)
    Example: "TB1 5e94d5b63f557b001420bbe3"

  - `data.details` (string)
    Example: "Client ID: 123ABC"

## Response 303 fields (application/json):

  - `data` (object)

  - `data.url` (string)
    The URL to the new location of the resource.

## Response 400 fields (application/json):

  - `status` (integer)
    The HTTP status code.
    Example: 400

  - `name` (string)
    BadRequest
    Example: "BadRequest"

  - `message` (string)
    The error message
    Example: "\\\"id\\\" should be a valid Mongo ObjectId."

## Response 401 fields (application/json):

  - `message` (string)
    Reason for the error such as incorrect service access, malformed, expired or deactivated token.
    Example: "Invalid token"

  - `name` (string)
    Unauthorized
    Example: "Unauthorized"

  - `status` (integer)
    The HTTP status code.
    Example: 401

## Response 404 fields (application/json):

  - `message` (string)
    Reason for the error such as incorrect service access, malformed, expired or deactivated token.
    Example: "Target entity not found"

  - `name` (string)
    NotFound
    Example: "NotFound"

  - `status` (integer)
    The HTTP status code.
    Example: 404

## Response 413 fields (application/json):

  - `message` (string)
    Reason for the error related to the payload size
    Example: "Response size is greater than 1MB"

  - `name` (string)
    PayloadTooLarge
    Example: "PayloadTooLarge"

  - `status` (integer)
    The HTTP status code.
    Example: 413