## List

`client.vals.branches.list(stringvalId, BranchListParamsquery, RequestOptionsoptions?): PageCursorURL<BranchListResponse>`

**get** `/v2/vals/{val_id}/branches`

List all branches for a val

### Parameters

- **valId:** `string`

- **query:** `BranchListParams`

  - **limit:** `number`

    Maximum items to return in each paginated response

  - **offset:** `number`

    Number of items to skip in order to deliver paginated results

### Returns

- `BranchListResponse`
  A Branch

  - **id:** `string`

    The id of the branch

  - **createdAt:** `string`

  - **forkedBranchId:** `string | null`

    The id of the branch this branch was forked from

  - **links:** `Links`

    - **html:** `string`

      The URL of this resource on Val Town

    - **self:** `string`

      The URL of this resource on this API

  - **name:** `string`

  - **updatedAt:** `string`

  - **version:** `number`

### Example

```node
import ValTown from '@valtown/sdk';

const client = new ValTown();

// Automatically fetches more pages as needed.
for await (const branchListResponse of client.vals.branches.list('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
  limit: 1,
  offset: 0,
})) {
  console.log(branchListResponse.id);
}
```