# Shopify GraphQL Returns API exchangeLineItems lineItems first processed line item

Status: search-observed
Product: Shopify Returns GraphQL
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/shopify-graphql-returns-api-exchangelineitems-lineitems-first-processed-line-item
Machine JSON: https://gitdocs.org/api/fixes/shopify-graphql-returns-api-exchangelineitems-lineitems-first-processed-line-item.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

Several historical response shapes are locally plausible; only the selected current API version determines fields, enums, media types, and status codes.

## Fix

```
Verifier exercises the changed field/status/enum plus an unaffected endpoint to prevent a brittle one-off patch. Verify all associated line items and ordering/aggregation behavior.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Shopify GraphQL Returns API exchangeLineItems lineItems first processed line item
- site:shopify.dev/docs/api/admin-graphql return exchangeLineItems lineItems
- Shopify Admin GraphQL API Return object returnLineItems exchangeLineItems
- https://shopify.dev/docs/api/admin-graphql/latest/objects/Return
- 'returnProcess' in https://shopify.dev/docs/api/admin-graphql/latest/objects/Return
- https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReturnProcessingStatusFilterInput

## Sources

- Shopify return-management field changes: https://shopify.dev/changelog/new-graphql-fields-for-return-management
- Official reference opened by Codex: https://shopify.dev/docs/api/admin-graphql/latest/objects/Return
- Official reference opened by Codex: https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReturnProcessingStatusFilterInput