updateListingInventory requires readiness state for digital listings (listing_type: download), contradicting docs & GET response

[amphelps535]

Hi Etsy Dev Team 👋

I believe I’ve hit a validation bug with updateListingInventory when working with digital listings.

The migration guide states:

“Digital listings cannot have processing profiles.”

However, when updating a digital listing’s inventory, the API rejects my request with:

"all offerings need readiness state"

Repro

Listing details (GET /listings/{exampleListingId}):

"listing_type": "download",
"readiness_state_id": null

Inventory (GET /listings/{exampleListingId}/inventory):

{
  "products": [
    {
      "sku": "",
      "offerings": [
        {
          "quantity": 999,
          "is_enabled": true,
          "price": { "amount": 415, "divisor": 100, "currency_code": "USD" },
          "readiness_state_id": null
        }
      ],
      "property_values": []
    }
  ],
  "readiness_state_on_property": []
}

So the API itself already returns readiness_state_id: null for the digital listing.

Update attempt (PUT /listings/{exampleListingId}/inventory):

{
  "products": [
    {
      "sku": "5",
      "offerings": [
        { "quantity": 999, "price": 4.15, "is_enabled": true }
      ]
    }
  ]
}

Result:
"all offerings need readiness state"

Why this looks like a bug

• Docs explicitly say digital listings cannot have processing profiles.
• GET responses show readiness_state_id: null.
• PUT rejects the same structure unless a readiness state is provided.
• This appears to be a mismatch between validation logic and documented behavior.

Request

• Can you confirm if this is a bug?
• If intended, can you provide an example of a valid updateListingInventory payload for a digital listing? (Current docs don’t show one.)
• If it’s a bug, can you advise on timeline or recommended workaround (legacy mode, explicit null, etc.)?

Thank you!

[openapi-support[bot]]

Thank you for letting us know. We're working on a patch right now.

[openapi-support[bot]]

A patch for this has been released. Thanks again for the report!

[sjuerges]

This is still an issue. For example: Platy Syncer Plugin for Wordpress Woocommerce throws the same "HTTP 400 - a readiness_state_id is required errors even for digital listings.