The Marketplace Tax Forms API Guide explains how partners retrieve available tax forms and download a PDF copy of a 1099-K. Use these APIs to automate year-end reporting, reduce manual work, and offer a self-serve experience in your tools. This guide is designed for Walmart Marketplace partners, sellers, and their developers who manage payouts and compliance.

Use cases

• Lists the payout years and tax form entries (1099-K) with formId per year for the specified partner and tenant.
• Confirms whether a 1099-K exists for a given year.
• Downloads the 1099-K as a PDF for storage or distribution.

Key capabilities

• Query the years in which payouts occurred and whether a 1099-K is available.
• Retrieve the unique form ID to download the PDF for that year.
• Download a base64-encoded PDF payload for the selected form.

Target audience

Partners and developers who manage finance and compliance workflows for Walmart Marketplace sellers

How it works

1. Call Get tax forms to fetch payout years and the available 1099-K forms for the partner and tenant.
2. From the response, locate the payoutYear, formType, and formId.
3. Call Download tax form with payoutYear, taxFormType, and formId to get the PDF as base64.
4. Decode and save the PDF file.

Prerequisites

• A Walmart Marketplace seller account and production API credentials.
• OAuth access token from the Token API.
• The following request headers on every call:
  WM_SEC.ACCESS_TOKEN, WM_QOS.CORRELATION_ID, WM_SVC.NAME, WM_GLOBAL_VERSION, WM_MARKET, WM.PARTNER_ID, WM.TENANT_ID. channelType is optional.
• Permission to access seller tax documents.

Market availability

U.S. Marketplace.

Next steps

• Implement Get tax forms to enumerate available forms.

• Implement Download tax form to retrieve the PDF.

• See the API references:

  • Get tax forms API Reference
  • Download tax form API Reference