Important API Reminder: when_made Field Enum Values

[openapi-support[bot]]

Hello API Developers,

This is a friendly reminder regarding the when_made field in our API.

As part of our annual data range updates, the valid enum values for the when_made field are refreshed.

Here are all the currently valid enum values for the when_made field:

• made_to_order
• 2020_2025
• 2010_2019
• 2006_2009
• before_2006
• 2000_2005
• 1990s
• 1980s
• 1970s
• 1960s
• 1950s
• 1940s
• 1930s
• 1920s
• 1910s
• 1900s
• 1800s
• 1700s
• before_1700

What this means for you:

• Any API requests attempting to use legacy values (like 2020_2024 or 2020_2023) or any other invalid value for the when_made field will result in an HTTP 400 Bad Request response.
• Please ensure your applications are updated to use only the values listed above to avoid disruptions.

Where to find the latest information:

For the most up-to-date and complete list of valid enum values for the when_made field, always refer to our official API Reference Documentation:

➡️ [https://developer.etsy.com/documentation/reference]

We appreciate you keeping your integrations up-to-date. If you have any questions or run into issues after updating, please don't hesitate to reach out to our support channels.

Questions? Contact us at developers@etsy.com.

[SFDannyCalladine]

When is this happening?

[ninjacell81]

Hi,

These values have already been updated with new ones. According to the API documentation they are:

"made_to_order" "2020_2026" "2010_2019" "2007_2009" "before_2007" "2000_2006" "1990s" "1980s" "1970s" "1960s" "1950s" "1940s" "1930s" "1920s" "1910s" "1900s" "1800s" "1700s" "before_1700"

Is the before_2007 a mistake? Shouldn't that be before_2006, if anything?

And please provide an endpoint where we can query these constant values. In the earliest version of the API there were endpoints for these.

Best wishes