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

# Get Subject

> Retrieve a subject by its unique identifier

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the subject
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique identifier for the subject
</ResponseField>

<ResponseField name="type" type="string">
  Subject type: `user`, `api_key`, `service`, or `agent`
</ResponseField>

<ResponseField name="externalId" type="string">
  External identifier for the subject
</ResponseField>

<ResponseField name="metadata" type="object">
  Additional metadata associated with the subject
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.example.com/subjects/sub_123' \
    -H 'Authorization: Bearer YOUR_TOKEN'
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const { data } = await axios.get('https://api.example.com/subjects/sub_123', {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "sub_123",
    "type": "user",
    "externalId": "user-456",
    "metadata": {
      "name": "John Doe",
      "email": "john@example.com"
    }
  }
  ```
</ResponseExample>