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

# General Sector History

> Returns the general history of sector changes.

## Endpoint

`GET https://gateway.orkeia.ai/sectors/history`

**Authentication**\
Requires header `authorization:  <your_token>`.

## Example (cURL)

```bash theme={null}
curl -X GET "https://gateway.orkeia.ai/sectors/history" \
  -H "authorization:  <your_token>"
```

## Responses

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": [
    {
      "id": "hist_001",
      "sectorId": "SECTOR_12345",
      "responsible": "admin@orkeia.ai",
      "action": "created sector",
      "type": "success",
      "date": "2024-07-22T14:25:18.000Z"
    }
  ]
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```

## History Fields

| Name        | Type   | Description                                                              |
| ----------- | ------ | ------------------------------------------------------------------------ |
| id          | string | Unique identifier of the history event.                                  |
| sectorId    | string | Identifier of the sector associated with the event.                      |
| responsible | string | Name/username responsible for the change.                                |
| action      | string | Registered action (e.g., created sector, updated sector, deleted sector) |
| type        | string | Classification of the event (`success`, `fail`, `neutral`).              |
| date        | Date   | Date and time of the change.                                             |