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

# List versions

> List every operating-instructions version for your storefront, newest first

`GET /api/v2/storefront/operating-instructions`

Returns all operating-instructions versions for your storefront, newest first. The active version (if any) is flagged with `isActive: true` on its row. Use this to render version history or find the number to re-activate.

## Request

```bash theme={null}
curl "https://api.interchange.io/api/v2/storefront/operating-instructions" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

This endpoint takes no parameters.

## Response

```json theme={null}
[
  {
    "id": "43",
    "storefrontId": "1234",
    "version": 3,
    "content": "# Merchandising rules\n\nLead with premium CTV. Never surface remnant display to holding-company buyers.",
    "notes": "clarify product packaging",
    "isActive": true,
    "createdAt": "2026-06-01T14:30:00Z",
    "createdBy": "5567",
    "ownershipIssues": []
  },
  {
    "id": "31",
    "storefrontId": "1234",
    "version": 2,
    "content": "# Merchandising rules\n\nLead with premium CTV.",
    "notes": null,
    "isActive": false,
    "createdAt": "2026-05-12T09:05:00Z",
    "createdBy": "5567",
    "ownershipIssues": []
  }
]
```

Returns an array of `OperatingInstructionsResponse` objects, newest version first. At most one item has `isActive: true`; when no version has been activated yet, every row reports `isActive: false`.

## Errors

* `400 VALIDATION_ERROR` — malformed request.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Operating instructions tasks" href="/v2/storefront/operating-instructions/tasks" icon="list-check">
    All operating-instructions operations
  </Card>

  <Card title="Get active version" href="/v2/storefront/operating-instructions/tasks/get-active" icon="circle-check">
    Just the version in force now
  </Card>

  <Card title="Create version" href="/v2/storefront/operating-instructions/tasks/create-version" icon="plus">
    Author a new version
  </Card>

  <Card title="Operating instructions overview" href="/v2/storefront/operating-instructions/overview" icon="scroll">
    Concepts and versioning model
  </Card>
</CardGroup>