> ## 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.

# fulfillmentBatches

> List the store's fulfillment batches, newest first. Filter by status for batches still printing, and by creation time for a day's batches.

**Required scopes:** [`shipping_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-shipping_read)

**Store must have one of:** `OMS`, `WMS`

## Arguments

**after** `String`

Forward pagination cursor — returns fulfillment batches after it.

**before** `String`

Backward pagination cursor — returns fulfillment batches before it.

**createdAtAfter** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

Only include batches created at or after this instant.

**createdAtBefore** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

Only include batches created at or before this instant.

**first** `Int`

Forward pagination: returns the first N fulfillment batches (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N fulfillment batches (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**orderBy** `[FulfillmentBatchSortKey](/docs/api-reference/v3/reference/shipping/fulfillment-batch-sort-key)`

Which key to sort by (defaults to the first key, newest-first). Combine with `reverse` to flip direction.

**reverse** `Boolean`

Reverses the sort direction selected by `orderBy` (or its default).

**status** `[\[FulfillmentBatchStatus!\]](/docs/api-reference/v3/reference/shipping/fulfillment-batch-status)`

Only include batches with one of these statuses.

## Returns

**fulfillmentBatches** `[FulfillmentBatchConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of FulfillmentBatch items.

**fields**

**edges** `[\[FulfillmentBatchEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[FulfillmentBatch!](/docs/api-reference/v3/reference/shipping/fulfillment-batch)` *required*

The item at this edge.

**fields**

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the batch was created.

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

The id of this batch.

**name** `String!` *required*

The batch number shown in the Redo app, e.g. "0030".

**status** `[FulfillmentBatchStatus!](/docs/api-reference/v3/reference/shipping/fulfillment-batch-status)` *required*

Where the batch is in its lifecycle.

**nodes** `[\[FulfillmentBatch!\]!](/docs/api-reference/v3/reference/shipping/fulfillment-batch)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the batch was created.

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

The id of this batch.

**name** `String!` *required*

The batch number shown in the Redo app, e.g. "0030".

**status** `[FulfillmentBatchStatus!](/docs/api-reference/v3/reference/shipping/fulfillment-batch-status)` *required*

Where the batch is in its lifecycle.

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  fulfillmentBatches(after: "...", before: "...", createdAtAfter: "...", createdAtBefore: "...", first: 10, last: 10, orderBy: CREATED_AT, reverse: true, status: FAILED) {
    nodes {
      createdAt
      id
      name
      status
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


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