Skip to main content
GET
/
subjects
/
{id}
curl -X GET 'https://api.example.com/subjects/sub_123' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "id": "sub_123",
  "type": "user",
  "externalId": "user-456",
  "metadata": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

​
Path Parameters

​
id
string
required
The unique identifier of the subject

​
Response

​
id
string
Unique identifier for the subject
​
type
string
Subject type: user, api_key, service, or agent
​
externalId
string
External identifier for the subject
​
metadata
object
Additional metadata associated with the subject
curl -X GET 'https://api.example.com/subjects/sub_123' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "id": "sub_123",
  "type": "user",
  "externalId": "user-456",
  "metadata": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}