Skip to main content
cURL
Cost: Free.
An update is the structured record of one Etsy change, as List updates explains. news_slug names the Etsy News article that tells sellers about it, when there is one.

Authorizations

Authorization
string
header
required

An API key: Authorization: Bearer alura_sk_....

Path Parameters

id
string
required

The update ID, such as 2026-10-19-us-entry-type-13.

Maximum string length: 80
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"2026-10-19-us-entry-type-13"

Query Parameters

fields
string

Comma-separated dotted paths to return; id, object and as_of always come back.

Response

OK

object
string
required
Allowed value: "etsy.update"
id
string
required

The update ID, a slug such as 2026-10-19-us-entry-type-13.

kind
enum<string>
required

What area of selling on Etsy it changes.

Available options:
fees,
listing_rules,
policies,
search,
programs,
payments,
shipping
title
string
required

What changed, in one line.

summary
string
required

The facts in at most two sentences: what, who and from when.

status
enum<string>
required

announced (not in effect yet), in_effect, or withdrawn (Etsy called it off).

Available options:
announced,
in_effect,
withdrawn
announced_at
string
required

The day Etsy announced it, YYYY-MM-DD.

effective_at
string | null
required

The day it takes or took effect, YYYY-MM-DD; null when Etsy gave no day.

countries
string[] | null
required

The seller countries it applies to (ISO 3166-1 alpha-2); null when it applies everywhere.

Maximum array length: 60
affects
object[]
required

The listing rules, fees, policies and programs it changes; empty when it changes none Alura tracks.

Maximum array length: 10
sources
object[]
required

Etsy's own pages the facts come from, the main one first.

Required array length: 1 - 8 elements
news_slug
string | null
required

The Etsy News article about it, when there is one (GET /v1/etsy/news/{slug}).

updated_at
string
required

When Alura last changed this record (ISO 8601, UTC).