ShopReceipt API does not return recipient name and shipping address

[thanh-it]

Confirmation

• I confirm this post does NOT contain sensitive data for my account.

Question / discussion

Hello Etsy Open API team,

Our application has Commercial Access, and Etsy sellers connect their shops to our application through OAuth.

We are using the transactions_r scope and retrieving orders through endpoints such as:

GET /v3/application/shops/{shop_id}/receipts
GET /v3/application/shops/{shop_id}/receipts/{receipt_id}

The API successfully returns the order/receipt information, but we are not receiving the recipient's name and shipping address information.

The affected fields include:

• name
• first_line
• second_line
• city
• state
• zip
• country_iso
• formatted_address

These fields are either missing, null, or empty in the ShopReceipt response.

The same order contains the recipient name and full shipping address when viewed directly in Etsy Seller/Shop Manager, so the shipping information exists on the Etsy order.

We understand from the API documentation that access to some ShopReceipt address fields may depend on the region and Etsy Preferred Partner status.

Could you please clarify:

1. Is the missing shipping address caused by our Commercial Access application not having Preferred Partner status or not being in an approved category?

2. Does the same restriction also apply to the name field? The current API documentation appears to specifically mention restrictions for the address fields, but not name.

3. What permission or application approval is required for a Commercial Access application to retrieve the recipient name and complete shipping address?

4. Is access determined by the Commercial Application itself, the connected Etsy seller/shop, the seller's region, or the buyer/shipping destination?

5. If our application needs this information specifically for order management and fulfillment, what is the current process for requesting access?

Our use case requires the recipient name and shipping address only for order fulfillment on behalf of Etsy sellers who explicitly connect their shops to our application.

We do not use this information for marketing or any unrelated purpose.

Thank you.

[openapi-support[bot]]

Hi thanh-it, thank you for taking the time to describe your use case.

The missing address fields are most likely caused by your application not being approved under a certain category — Commercial Access alone is not sufficient to retrieve those fields. Regarding the name field, it is not subject to the same restriction as the address fields, so if you are receiving it as null or empty, that would be a data issue on the specific order rather than a permissions problem. If your use case requires access to shipping address fields for order fulfillment on behalf of connected sellers, you can request a category change by emailing us at developers@etsy.com and our team will review your application and advise on next steps.

[thanh-it]

I sent an email but haven't received a response from you yet.

[thanh-it]

Why update tracking number error code 403 {"error":"Unauthorized"}?
request UUID EuhX5vPDiu_n6Ed7J1HrHbVSpY2e
Please check.

[1ZoZ1]

You cannot fulfill an order via the API if you cannot see the information or access the customer details. Send an email to Etsy. developers@etsy.com