# Alberta Utilities Commission · List documents

Get industry and reference data with Alberta Utilities Commission · List documents from Alexandria through one Spiral API key. Find decisions, notices or approvals by proceeding, applicant, date or type; feed `get_document` with `efiling_document_id`. Not for proceedings' party lists or exhibits (eFiling login only). It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Industry Data
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `auc-ab-ca/regulatory-decision/list_documents`
- Page: https://spiral.ai/tools/alexandria/auc-ab-ca/regulatory-decision/list_documents

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `sort` | one of | newest, oldest | newest | Table order: newest first (the site's default) or oldest first. |
| `year` | text |  | — | Keep only rows issued in this year. Pattern: ^[0-9]{4}$. |
| `limit` | number | 1 to 1000 | 100 | Rows to return (matching rows when a filter is set). |
| `cursor` | text |  | — | `next_cursor` from the previous page: the absolute row offset to resume from. Pattern: ^[0-9]{1,7}$. |
| `dataset` | one of | decisions, recent_updates, notices, facility_approvals, gas_pipeline_licences, monthly_energy_charges, monthly_gas_charges | decisions | Which regulatory documents table to read. `decisions` covers dispositions from late 2022 onwards; `recent_updates` is the last 30 days across all types; `monthly_*` tables carry no document type, proceeding id or division columns. |
| `division` | text |  | — | Case-insensitive division name (Facilities, Rates, Law, Markets, ...). |
| `applicant` | text |  | — | Case-insensitive substring of the applicant name (e.g. 'AltaLink'). |
| `document_type` | text |  | — | Case-insensitive substring of the document type (e.g. 'Decision report', 'Approval', 'Notice of application', 'Electric facility permit'). |
| `proceeding_id` | text |  | — | Keep only rows of this AUC proceeding (e.g. 30958). Pattern: ^[0-9]{1,8}$. |
| `document_number` | text |  | — | Keep only the row with this exact document number (e.g. 30958-D01-2026, 31108-F0004, licence 1670). |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "auc-ab-ca/regulatory-decision/list_documents",
    "input": {
      "sort": "newest"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=auc-ab-ca%2Fregulatory-decision%2Flist_documents

## Common questions

### Alberta Utilities Commission · List documents

**How much does Alberta Utilities Commission · List documents cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Alberta Utilities Commission · List documents through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "auc-ab-ca/regulatory-decision/list_documents"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Alberta Utilities Commission · List documents?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Alberta Utilities Commission · List documents?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

