Dreaded 404 when requesting /payouts endpoint (even with correct App permissions)

Expected outcome

As a shop collaborator (with the Create and Develop Custom Apps and Manage and install apps and channels permissions assigned on my staff member profile) I expect that I can make a GET request of the /payouts.json Admin API endpoint and receive a 200 OK response with the array of payout items as described in the Shopify API documentation

Actual outcome

When I made the (Admin API) GET request of the /payouts.json endpoint, I got the dreaded (and oft discussed ) 404/HTML not found response, even though:

  • I triple checked the url/endpoint configuration (and have successfully requested from other endpoints with the exact same url formatting with only the payouts endpoint swapped in
  • I have successfully retrieved lists of the orders.json records and even a single balance_transaction record

What I did

  1. user role perms on the shop
    1. Create and Develop Custom Apps
    2. Manage and install apps and channels
  2. create app with permissions scopes that include
    1. read_shopify_payments_payouts
    2. read_shopify_payments_accounts
    3. note: I did not see any option or button for Request all scopes in my app’s API Configuration section or anywhere else
  3. installed my custom app into the shop

I have referenced these other Shopify forum posts before posting my own query: