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

# ReturnActionRun

> One run of a return action over a set of returns. A run works through its returns in the background; poll `returnActionRun` until `status` is no longer `RUNNING`.

**Required scopes:** [`returns_read`](/docs/api-reference/v3/reference/scopes#scope-returns_read), [`returns_write`](/docs/api-reference/v3/reference/scopes#scope-returns_write)

**action**

The action the run applies. Null for the moment before a run that has only just started reports it.

**counts** *required*

Outcome totals so far.

**fields**

**alreadyRunning** `Int!` *required*

Returns the same action was already in progress on, which the run left alone.

**failed** `Int!` *required*

Returns the action failed on.

**ok** `Int!` *required*

Returns the action was applied to.

**skipped** `Int!` *required*

Returns the action did not apply to.

**total** `Int!` *required*

The returns in the run.

**id** `ID!` *required*

The run's id, for `returnActionRun`.

**results** *required*

One entry per return, in the order they were given. Live while the run is `RUNNING`.

**fields**

**code** `String`

A stable code for a skipped or failed return, such as `INELIGIBLE` or `CLAIM_UNDER_REDO_REVIEW`.

**message** `String`

Why the return was skipped or failed.

**returnId** `ID!` *required*

The id of the return. Read the return itself with the `return` query.

**status** *required*

What the run did to this return.

**status** *required*

Whether the run is still working.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.