Docs
Get History
GET /history?subjectType=Area&subjectId={subjectId}&organizationId={organizationId}
GET
/history?subjectType=Area&subjectId={subjectId}&organizationId={organizationId}Returns the audit history for a specific subject entity — an ordered list of domain events that occurred on it. History records are projected from the outbox event pipeline and provide a full activity log for any entity in the system.
Required Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <token> | Optional | Authenticate via OAuth2 in Bruno. |
Query Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| subjectType | string | Required | Type of the subject entity to retrieve history for (e.g. Area, Task, Crew). |
| subjectId | Guid | Required | ID of the subject entity. |
| organizationId | Guid | Optional | Organization context for the subject. |
| eventId | Guid | Optional | Event context for the subject. Omit for org-level subjects. |
Response
Returns a list of history records in chronological order.
| Field | Type | Description |
|---|---|---|
| id | Guid | Unique history record ID. |
| outboxEventId | Guid | ID of the originating outbox event. |
| subjectType | string | Type of the subject entity. |
| subjectId | Guid | ID of the subject entity. |
| subjectDisplayName | string | Human-readable name of the subject at the time of the event. |
| organizationId | Guid | Organization context. |
| eventId | Guid| null | Event context. Null for org-level history. |
| eventType | string | The domain event type that occurred (e.g. AreaUpdated, TaskAssigned). |
| eventVersion | int | Version number of the domain event schema. |
| actorType | string | Who performed the action (e.g. User, System, ApiKey). |
| actorUserId | Guid| null | ID of the user who performed the action. Null for system actions. |
| actorApiKeyId | Guid| null | ID of the API key used. Null for user actions. |
| actorDisplayName | string | Display name of the actor at the time of the event. |
| occurredAt | DateTime | When the domain event occurred. |
| projectedAt | DateTime | When the event was projected into the history store. |