# Subjects

- Method: `GET`
- Path: `/subjects`
- Tier: Free
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-subjects/
- Interactive docs: https://docs.hiddensystems.ai/nebula/api/#endpoint=get-subjects

## Description

Discovers non-asset people, accounts, and topics, including AI-related subjects, and returns canonical subject_id values accepted by subject-aware endpoints. Assets and tickers are deliberately excluded; use /assets for them. Search uses the same canonical names, aliases, merge resolution, and ranking as Nebula's internal subject resolver. Supply query for search or subject_id for exact resolution. Parameter rules: subject_id and query cannot be combined.

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/subjects' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

No path parameters for this endpoint.

## Query Parameters

- `subject_id` (string, optional): Canonical non-asset identifier returned by /subjects. It cannot be combined with asset_id or asset_class.
- `query` (string, optional): Case-insensitive search across public identifiers and names.
- `limit` (integer, optional, default: 50): Maximum results returned.
- `offset` (integer, optional, default: 0): Number of results skipped.

## Response

OK

- `has_more` (boolean, required): True when another page is available after the returned records.
- `limit` (integer, required): Maximum records requested.
- `offset` (integer, required): Number of matching records skipped.
- `subjects` (array<object>, required): Non-asset subjects matching the discovery filters.
- `subjects[].name` (string, required): Human-readable name.
- `subjects[].subject_id` (string, required): Canonical identifier for a non-asset person, account, or topic.

Media type: `application/json`

## JSON Response

```json
{
  "has_more": false,
  "limit": 50,
  "offset": 0,
  "subjects": [
    {
      "name": "Artificial Intelligence",
      "subject_id": "text:artificial intelligence"
    }
  ]
}
```