---
title: "epics"
canonical: "https://support.appfire.com/space/PSJC/570458590/epics"
format: markdown
---
> Macro (aura-html)


## Description

> Macro (excerpt)
> 
> Retrieves a list of all the epics within a project or system.

Retrieves a list of all the epics within a project or system, helping to manage and track high-level project goals and initiatives.

|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | epics(boardId) | **Package** |  |
| **Alias** |  | **Pkg Usage** |  |

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| boardId | Integer | Yes | The board id |

## Return Type

**[JEpic []](https://appfire.atlassian.net/wiki/spaces/PSJC/pages/435028065)**

The epic structures array

## Example

```javascript
JEpic [] epics = epics(12345);
for(JEpic e in epics) {
     runnerLog(e.name);
}
```

## See also

> Macro (contentbylabel)