can't find marketplace_orders in access scope to get a list of order data

Shopify Apps

Topic summary

Main issue: Developers couldn’t find a “marketplace_orders” access scope to retrieve order data and were blocked by an error referencing it (e.g., GraphQL refundCreate denied requiring orders, marketplace_orders, or buyer_membership_orders). One user also saw ECONNREFUSED and suspected scopes.

Key clarification: You don’t need a separate marketplace_orders scope. Adding either read_orders or write_orders is sufficient for accessing order data and using refundCreate. To access orders older than 60 days, request read_all_orders from the Shopify Partners Dashboard.

Context notes:

  • One developer confirmed they could get order counts but not full order data before adjusting scopes.
  • The documentation was described as misleading regarding marketplace_orders.

Outcome: Resolved. The practical fix is to grant read_orders or write_orders, and add read_all_orders when historical (>60 days) access is required. Other participants later confirmed the solution worked.

Summarized with AI on December 16. AI used: gpt-5.
1

Hey, I’m currently trying to get order data so I can use inside of my app, that I’m using for personal use.

I have found the read_orders scope but not the marketplace_orders scope throughout the access scope docs

and the error I get is Error: connect ECONNREFUSED

So I know this error is related to the access scope

I would appreciate any help or to know if I am overlooking something in the docs

FYI: I know the orders scope works cause I can get the order count but not the order data

2 
Access denied for refundCreate field. Required access: Any of `orders`, `marketplace_orders`, `buyer_membership_orders` access scopes

I think we’re somehow have related issue. Can’t seem to find where to set/request these missing permissions for calling refundCreate in my admin action.

3

did you ever figure anything out for this?

4

Hi @bguse ,

The documentation can sometimes be misleading. Though here’s how we solved it. You just need to add either read_orders or write_orders scope. If you’d be needing to access orders beyond the 60 days, you would be needing to to request for the read_all_orders scope in the Shopify Partners Dashboard.

I hope that helps!

1 Like
5

thanks! i was able to figure it out shortly after posting this. i haven’t logged on in a while to this account saw that you replied so I wanted to say thank you even though it was a few months ago. lol!

1 Like
6

Hi @bguse ,

Yup, it’s been awhile. Glad everything’s good on your end now!