curl "https://api.alura.io/v1/etsy/updates?since=2026-09-01&country=GB" \
  -H "Authorization: Bearer $ALURA_API_KEY"

const res = await fetch('https://api.alura.io/v1/etsy/updates?since=2026-09-01&country=GB', {
  headers: {
    Authorization: `Bearer ${process.env.ALURA_API_KEY}`,
  },
});
console.log(await res.json());

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.alura.io/v1/etsy/updates?since=2026-09-01&country=GB",
    headers={
        "Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
    },
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))

{
  "object": "list",
  "data": [
    {
      "object": "etsy.update",
      "id": "2026-10-20-share-and-save-holiday-refund",
      "kind": "fees",
      "title": "Share & Save refunds the full 6.5% transaction fee through January 4, 2027",
      "summary": "From October 20, 2026 through January 4, 2027, sellers enrolled in Share & Save get the full 6.5% transaction fee refunded on eligible orders that come through their Share & Save links, up from the usual 4%. The refund returns to 4% after January 4, 2027.",
      "status": "in_effect",
      "announced_at": "2026-10-20",
      "effective_at": "2026-10-20",
      "countries": null,
      "affects": [
        {
          "type": "fee",
          "key": "share_and_save_refund"
        },
        {
          "type": "program",
          "key": "share_and_save"
        }
      ],
      "sources": [
        {
          "url": "https://community.etsy.com/forum/announcements-290/topic/our-share-save-holiday-gift-to-you-190476/",
          "title": "Our Share & Save holiday gift to you",
          "publisher": "Etsy",
          "published_at": "2026-10-20",
          "read_at": null
        },
        {
          "url": "https://help.etsy.com/hc/en-us/articles/16981332744087",
          "title": "How to Save on Etsy Fees with the Share & Save Program",
          "publisher": "Etsy",
          "published_at": "2026-10-20",
          "read_at": null
        }
      ],
      "news_slug": "share-and-save-holiday-refund",
      "updated_at": "2026-10-22T09:00:00.000Z"
    },
    {
      "object": "etsy.update",
      "id": "2026-10-19-us-entry-type-13",
      "kind": "shipping",
      "title": "US requires electronic Entry Type 13 filing for postal parcels from January 20, 2027",
      "summary": "From January 20, 2027, international postal packages worth $2,500 USD or less entering the US must be filed electronically in US Customs' ACE system under Entry Type 13, with shipment-level data and any documents US agencies such as the FDA or CPSC require. Etsy says packages without the required customs information may be held or returned, and recommends connecting the shop to a free Zonos Verified Account.",
      "status": "announced",
      "announced_at": "2026-10-19",
      "effective_at": "2027-01-20",
      "countries": null,
      "affects": [],
      "sources": [
        {
          "url": "https://community.etsy.com/forum/announcements-290/topic/new-us-customs-postal-entry-requirements-for-international-sellers-190423/",
          "title": "New US customs postal entry requirements for international sellers",
          "publisher": "Etsy",
          "published_at": "2026-10-19",
          "read_at": null
        }
      ],
      "news_slug": "us-entry-type-13-postal",
      "updated_at": "2026-10-22T09:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total": {
    "value": 2,
    "relation": "eq"
  }
}

{
  "type": "https://docs.alura.io/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "Invalid request",
  "suggestion": "Fix the request as the detail says, then send it again.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "Unauthorized",
  "suggestion": "Send a valid API key as `Authorization: Bearer alura_sk_...`.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/credits_exhausted",
  "title": "API credits exhausted",
  "status": 402,
  "code": "credits_exhausted",
  "detail": "API credits exhausted",
  "suggestion": "Upgrade the plan or wait for the monthly reset.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/plan_required",
  "title": "Plan required",
  "status": 403,
  "code": "plan_required",
  "detail": "Plan required",
  "suggestion": "Upgrade the workspace plan to use this operation.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "Not found",
  "suggestion": "Check the ID, or search for it first.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/method_not_allowed",
  "title": "Method not allowed",
  "status": 405,
  "code": "method_not_allowed",
  "detail": "Method not allowed",
  "suggestion": "Use one of the methods in the Allow header.",
  "retryable": false,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limited",
  "suggestion": "Wait for Retry-After, then retry.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/internal_error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "Internal error",
  "suggestion": "Retry; if it keeps failing, report the request_id.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}

{
  "type": "https://docs.alura.io/errors/credits_unavailable",
  "title": "API credits unavailable",
  "status": 503,
  "code": "credits_unavailable",
  "detail": "API credits unavailable",
  "suggestion": "Retry shortly.",
  "retryable": true,
  "request_id": "req_01JQ5W3H8M2N4P6R8T0V2X4Z6B"
}