bidkit 0.1.0__py3-none-any.whl

bidkit/generated/models/sell_metadata.py

@@ -0,0 +1,2552 @@
+# ruff: noqa
+# generated by datamodel-codegen:
+#   filename:  sell_metadata_v1_oas3.json
+
+from __future__ import annotations
+
+from bidkit.models import OpenStrEnum
+
+from bidkit.models import EbayModel
+from pydantic import Field
+
+
+class AdFormatEnabledEnum(OpenStrEnum):
+    disabled = 'DISABLED'
+    enabled = 'ENABLED'
+    only = 'ONLY'
+    classified_ad_enabled = 'CLASSIFIED_AD_ENABLED'
+    classified_ad_only = 'CLASSIFIED_AD_ONLY'
+    local_market_best_offer_only = 'LOCAL_MARKET_BEST_OFFER_ONLY'
+
+
+class CardinalityEnum(OpenStrEnum):
+    single = 'SINGLE'
+    multi = 'MULTI'
+
+
+class ClassifiedAdBestOfferEnabledEnum(OpenStrEnum):
+    disabled = 'DISABLED'
+    enabled = 'ENABLED'
+    required = 'REQUIRED'
+
+
+class ClassifiedAdPaymentMethodEnabledEnum(OpenStrEnum):
+    enabled_with_checkout = 'ENABLED_WITH_CHECKOUT'
+    enabled_without_checkout = 'ENABLED_WITHOUT_CHECKOUT'
+    not_supported = 'NOT_SUPPORTED'
+
+
+class ClassifiedAdPolicy(EbayModel):
+    ad_format_enabled: AdFormatEnabledEnum | None = Field(
+        None,
+        alias='adFormatEnabled',
+        description='This enumerated value indicates the type or status of available Classified Ad formats for this category.',
+    )
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    classified_ad_auto_accept_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdAutoAcceptEnabled',
+        description='Indicates whether the category supports the Best Offer Automatic Accept feature for Classified Ad listings.',
+    )
+    classified_ad_auto_decline_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdAutoDeclineEnabled',
+        description='Indicates whether the category supports the Best Offer Automatic Reject feature for Classified Ad listings.',
+    )
+    classified_ad_best_offer_enabled: ClassifiedAdBestOfferEnabledEnum | None = Field(
+        None,
+        alias='classifiedAdBestOfferEnabled',
+        description='This enumerated value indicates if Best Offer is enabled, disabled, or required for Classified Ad listings in this category.',
+    )
+    classified_ad_company_name_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdCompanyNameEnabled',
+        description="Indicates whether this category supports including a company name in the seller's contact information. This element is for For Sale By Owner listings.",
+    )
+    classified_ad_contact_by_address_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdContactByAddressEnabled',
+        description="Indicates whether this category supports including an address in the seller's contact information. This element is for For Sale By Owner listings.",
+    )
+    classified_ad_contact_by_email_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdContactByEmailEnabled',
+        description="Indicates whether most categories support including an email address in the seller's contact information.",
+    )
+    classified_ad_contact_by_phone_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdContactByPhoneEnabled',
+        description="Indicates whether most categories support including a phone number in the seller's contact information.",
+    )
+    classified_ad_counter_offer_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdCounterOfferEnabled',
+        description='Indicates whether counter offers are allowed on Best offers for the category.',
+    )
+    classified_ad_payment_method_enabled: (
+        ClassifiedAdPaymentMethodEnabledEnum | None
+    ) = Field(
+        None,
+        alias='classifiedAdPaymentMethodEnabled',
+        description='This enumerated value indicates support for the payment method being displayed to the user for the category. Even if enabled, checkout may or may not be enabled.',
+    )
+    classified_ad_phone_count: int | None = Field(
+        None,
+        alias='classifiedAdPhoneCount',
+        description='Indicates how many contact phone numbers can be specified in contact information for the category. This element is for For Sale By Owner listings.',
+    )
+    classified_ad_shipping_method_enabled: bool | None = Field(
+        None,
+        alias='classifiedAdShippingMethodEnabled',
+        description='Indicates if shipping methods can be specified and displayed in the View Item page for the category.',
+    )
+    classified_ad_street_count: int | None = Field(
+        None,
+        alias='classifiedAdStreetCount',
+        description='Indicates how many street addresses can be specified in contact information for the category. This element is for For Sale By Owner listings.',
+    )
+    seller_contact_details_enabled: bool | None = Field(
+        None,
+        alias='sellerContactDetailsEnabled',
+        description='Indicates whether this category supports seller-level contact information for Classified Ad listings.',
+    )
+
+
+class CompatibilityDetails(EbayModel):
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description='The name of the property being described.',
+    )
+    property_value: str | None = Field(
+        None,
+        alias='propertyValue',
+        description='The value for the property specified in the propertyName field.',
+    )
+
+
+class CompatibilityTypeEnum(OpenStrEnum):
+    specifications = 'SPECIFICATIONS'
+    assembly = 'ASSEMBLY'
+
+
+class CompatibleVehicleTypeEnum(OpenStrEnum):
+    us_cars_and_trucks = 'US_CARS_AND_TRUCKS'
+    us_motorcycles = 'US_MOTORCYCLES'
+    de_cars_and_trucks = 'DE_CARS_AND_TRUCKS'
+    uk_cars_and_trucks = 'UK_CARS_AND_TRUCKS'
+    us_atv = 'US_ATV'
+    au_cars_and_trucks = 'AU_CARS_AND_TRUCKS'
+    us_boats = 'US_BOATS'
+    us_atv_utv = 'US_ATV_UTV'
+    us_snowmobiles = 'US_SNOWMOBILES'
+    us_powersports = 'US_POWERSPORTS'
+    us_scooters = 'US_SCOOTERS'
+    us_golf_carts = 'US_GOLF_CARTS'
+    us_watercrafts = 'US_WATERCRAFTS'
+    de_motorcycles = 'DE_MOTORCYCLES'
+    de_scooters = 'DE_SCOOTERS'
+    uk_motorcycles = 'UK_MOTORCYCLES'
+    uk_scooters = 'UK_SCOOTERS'
+    it_cars_and_trucks = 'IT_CARS_AND_TRUCKS'
+    fr_cars_and_trucks = 'FR_CARS_AND_TRUCKS'
+    es_cars_and_trucks = 'ES_CARS_AND_TRUCKS'
+    ca_cars_and_trucks = 'CA_CARS_AND_TRUCKS'
+    default_value = 'DEFAULT_VALUE'
+
+
+class CountryCodeEnum(OpenStrEnum):
+    ad = 'AD'
+    ae = 'AE'
+    af = 'AF'
+    ag = 'AG'
+    ai = 'AI'
+    al = 'AL'
+    am = 'AM'
+    an = 'AN'
+    ao = 'AO'
+    aq = 'AQ'
+    ar = 'AR'
+    as_ = 'AS'
+    at = 'AT'
+    au = 'AU'
+    aw = 'AW'
+    ax = 'AX'
+    az = 'AZ'
+    ba = 'BA'
+    bb = 'BB'
+    bd = 'BD'
+    be = 'BE'
+    bf = 'BF'
+    bg = 'BG'
+    bh = 'BH'
+    bi = 'BI'
+    bj = 'BJ'
+    bl = 'BL'
+    bm = 'BM'
+    bn = 'BN'
+    bo = 'BO'
+    bq = 'BQ'
+    br = 'BR'
+    bs = 'BS'
+    bt = 'BT'
+    bv = 'BV'
+    bw = 'BW'
+    by = 'BY'
+    bz = 'BZ'
+    ca = 'CA'
+    cc = 'CC'
+    cd = 'CD'
+    cf = 'CF'
+    cg = 'CG'
+    ch = 'CH'
+    ci = 'CI'
+    ck = 'CK'
+    cl = 'CL'
+    cm = 'CM'
+    cn = 'CN'
+    co = 'CO'
+    cr = 'CR'
+    cu = 'CU'
+    cv = 'CV'
+    cw = 'CW'
+    cx = 'CX'
+    cy = 'CY'
+    cz = 'CZ'
+    de = 'DE'
+    dj = 'DJ'
+    dk = 'DK'
+    dm = 'DM'
+    do = 'DO'
+    dz = 'DZ'
+    ec = 'EC'
+    ee = 'EE'
+    eg = 'EG'
+    eh = 'EH'
+    er = 'ER'
+    es = 'ES'
+    et = 'ET'
+    fi = 'FI'
+    fj = 'FJ'
+    fk = 'FK'
+    fm = 'FM'
+    fo = 'FO'
+    fr = 'FR'
+    ga = 'GA'
+    gb = 'GB'
+    gd = 'GD'
+    ge = 'GE'
+    gf = 'GF'
+    gg = 'GG'
+    gh = 'GH'
+    gi = 'GI'
+    gl = 'GL'
+    gm = 'GM'
+    gn = 'GN'
+    gp = 'GP'
+    gq = 'GQ'
+    gr = 'GR'
+    gs = 'GS'
+    gt = 'GT'
+    gu = 'GU'
+    gw = 'GW'
+    gy = 'GY'
+    hk = 'HK'
+    hm = 'HM'
+    hn = 'HN'
+    hr = 'HR'
+    ht = 'HT'
+    hu = 'HU'
+    id = 'ID'
+    ie = 'IE'
+    il = 'IL'
+    im = 'IM'
+    in_ = 'IN'
+    io = 'IO'
+    iq = 'IQ'
+    ir = 'IR'
+    is_ = 'IS'
+    it = 'IT'
+    je = 'JE'
+    jm = 'JM'
+    jo = 'JO'
+    jp = 'JP'
+    ke = 'KE'
+    kg = 'KG'
+    kh = 'KH'
+    ki = 'KI'
+    km = 'KM'
+    kn = 'KN'
+    kp = 'KP'
+    kr = 'KR'
+    kw = 'KW'
+    ky = 'KY'
+    kz = 'KZ'
+    la = 'LA'
+    lb = 'LB'
+    lc = 'LC'
+    li = 'LI'
+    lk = 'LK'
+    lr = 'LR'
+    ls = 'LS'
+    lt = 'LT'
+    lu = 'LU'
+    lv = 'LV'
+    ly = 'LY'
+    ma = 'MA'
+    mc = 'MC'
+    md = 'MD'
+    me = 'ME'
+    mf = 'MF'
+    mg = 'MG'
+    mh = 'MH'
+    mk = 'MK'
+    ml = 'ML'
+    mm = 'MM'
+    mn = 'MN'
+    mo = 'MO'
+    mp = 'MP'
+    mq = 'MQ'
+    mr = 'MR'
+    ms = 'MS'
+    mt = 'MT'
+    mu = 'MU'
+    mv = 'MV'
+    mw = 'MW'
+    mx = 'MX'
+    my = 'MY'
+    mz = 'MZ'
+    na = 'NA'
+    nc = 'NC'
+    ne = 'NE'
+    nf = 'NF'
+    ng = 'NG'
+    ni = 'NI'
+    nl = 'NL'
+    no = 'NO'
+    np = 'NP'
+    nr = 'NR'
+    nu = 'NU'
+    nz = 'NZ'
+    om = 'OM'
+    pa = 'PA'
+    pe = 'PE'
+    pf = 'PF'
+    pg = 'PG'
+    ph = 'PH'
+    pk = 'PK'
+    pl = 'PL'
+    pm = 'PM'
+    pn = 'PN'
+    pr = 'PR'
+    ps = 'PS'
+    pt = 'PT'
+    pw = 'PW'
+    py = 'PY'
+    qa = 'QA'
+    re = 'RE'
+    ro = 'RO'
+    rs = 'RS'
+    ru = 'RU'
+    rw = 'RW'
+    sa = 'SA'
+    sb = 'SB'
+    sc = 'SC'
+    sd = 'SD'
+    se = 'SE'
+    sg = 'SG'
+    sh = 'SH'
+    si = 'SI'
+    sj = 'SJ'
+    sk = 'SK'
+    sl = 'SL'
+    sm = 'SM'
+    sn = 'SN'
+    so = 'SO'
+    sr = 'SR'
+    st = 'ST'
+    sv = 'SV'
+    sx = 'SX'
+    sy = 'SY'
+    sz = 'SZ'
+    tc = 'TC'
+    td = 'TD'
+    tf = 'TF'
+    tg = 'TG'
+    th = 'TH'
+    tj = 'TJ'
+    tk = 'TK'
+    tl = 'TL'
+    tm = 'TM'
+    tn = 'TN'
+    to = 'TO'
+    tr = 'TR'
+    tt = 'TT'
+    tv = 'TV'
+    tw = 'TW'
+    tz = 'TZ'
+    ua = 'UA'
+    ug = 'UG'
+    um = 'UM'
+    us = 'US'
+    uy = 'UY'
+    uz = 'UZ'
+    va = 'VA'
+    vc = 'VC'
+    ve = 'VE'
+    vg = 'VG'
+    vi = 'VI'
+    vn = 'VN'
+    vu = 'VU'
+    wf = 'WF'
+    ws = 'WS'
+    ye = 'YE'
+    yt = 'YT'
+    za = 'ZA'
+    zm = 'ZM'
+    zw = 'ZW'
+
+
+class CurrencyCodeEnum(OpenStrEnum):
+    aed = 'AED'
+    afn = 'AFN'
+    all = 'ALL'
+    amd = 'AMD'
+    aoa = 'AOA'
+    ars = 'ARS'
+    awg = 'AWG'
+    azn = 'AZN'
+    bam = 'BAM'
+    bbd = 'BBD'
+    bdt = 'BDT'
+    bgn = 'BGN'
+    bhd = 'BHD'
+    bif = 'BIF'
+    bmd = 'BMD'
+    bnd = 'BND'
+    bob = 'BOB'
+    brl = 'BRL'
+    bsd = 'BSD'
+    btn = 'BTN'
+    bwp = 'BWP'
+    byr = 'BYR'
+    bzd = 'BZD'
+    cad = 'CAD'
+    cdf = 'CDF'
+    clp = 'CLP'
+    cny = 'CNY'
+    cop = 'COP'
+    crc = 'CRC'
+    cup = 'CUP'
+    cve = 'CVE'
+    czk = 'CZK'
+    djf = 'DJF'
+    dop = 'DOP'
+    dzd = 'DZD'
+    egp = 'EGP'
+    ern = 'ERN'
+    etb = 'ETB'
+    fjd = 'FJD'
+    fkp = 'FKP'
+    gel = 'GEL'
+    ghs = 'GHS'
+    gip = 'GIP'
+    dkk = 'DKK'
+    gmd = 'GMD'
+    gnf = 'GNF'
+    gtq = 'GTQ'
+    gyd = 'GYD'
+    hkd = 'HKD'
+    hnl = 'HNL'
+    hrk = 'HRK'
+    htg = 'HTG'
+    huf = 'HUF'
+    idr = 'IDR'
+    inr = 'INR'
+    iqd = 'IQD'
+    irr = 'IRR'
+    isk = 'ISK'
+    gbp = 'GBP'
+    jmd = 'JMD'
+    jod = 'JOD'
+    jpy = 'JPY'
+    kes = 'KES'
+    kgs = 'KGS'
+    khr = 'KHR'
+    kmf = 'KMF'
+    kpw = 'KPW'
+    krw = 'KRW'
+    kwd = 'KWD'
+    kyd = 'KYD'
+    kzt = 'KZT'
+    lak = 'LAK'
+    lbp = 'LBP'
+    chf = 'CHF'
+    lkr = 'LKR'
+    lrd = 'LRD'
+    lsl = 'LSL'
+    ltl = 'LTL'
+    lyd = 'LYD'
+    mad = 'MAD'
+    mdl = 'MDL'
+    mga = 'MGA'
+    mkd = 'MKD'
+    mmk = 'MMK'
+    mnt = 'MNT'
+    mop = 'MOP'
+    mro_1 = 'MRO'
+    xcd = 'XCD'
+    mur = 'MUR'
+    mvr = 'MVR'
+    mwk = 'MWK'
+    mxn = 'MXN'
+    myr = 'MYR'
+    mzn = 'MZN'
+    nad = 'NAD'
+    ngn = 'NGN'
+    nio = 'NIO'
+    npr = 'NPR'
+    omr = 'OMR'
+    pab = 'PAB'
+    pen = 'PEN'
+    xpf = 'XPF'
+    pgk = 'PGK'
+    php = 'PHP'
+    pkr = 'PKR'
+    pln = 'PLN'
+    ils = 'ILS'
+    pyg = 'PYG'
+    qar = 'QAR'
+    ron = 'RON'
+    rsd = 'RSD'
+    rub = 'RUB'
+    rwf = 'RWF'
+    sar = 'SAR'
+    sbd = 'SBD'
+    scr = 'SCR'
+    sdg = 'SDG'
+    sek = 'SEK'
+    sgd = 'SGD'
+    shp = 'SHP'
+    nok = 'NOK'
+    sll = 'SLL'
+    sos = 'SOS'
+    srd = 'SRD'
+    std = 'STD'
+    ang = 'ANG'
+    syp = 'SYP'
+    szl = 'SZL'
+    xaf = 'XAF'
+    xof = 'XOF'
+    thb = 'THB'
+    tjs = 'TJS'
+    nzd = 'NZD'
+    tmt = 'TMT'
+    tnd = 'TND'
+    top = 'TOP'
+    try_ = 'TRY'
+    ttd = 'TTD'
+    aud = 'AUD'
+    twd = 'TWD'
+    tzs = 'TZS'
+    uah = 'UAH'
+    ugx = 'UGX'
+    usd = 'USD'
+    uyu = 'UYU'
+    uzs = 'UZS'
+    vef = 'VEF'
+    vnd = 'VND'
+    vuv = 'VUV'
+    wst = 'WST'
+    yer = 'YER'
+    eur = 'EUR'
+    zar = 'ZAR'
+    zmw = 'ZMW'
+    zwl = 'ZWL'
+
+
+class DescriptorUsageEnum(OpenStrEnum):
+    required = 'REQUIRED'
+
+
+class DisabledProductFilter(EbayModel):
+    exclude_for_ebay_reviews: bool | None = Field(
+        None,
+        alias='excludeForEbayReviews',
+        description='Specifies whether to filter out products excluded for eBay reviews. If set to true , items excluded from eBay reviews are not returned.',
+    )
+    exclude_for_ebay_selling: bool | None = Field(
+        None,
+        alias='excludeForEbaySelling',
+        description='Specifies whether to filter out products excluded for eBay selling. If set to true , items excluded from eBay selling are not returned.',
+    )
+
+
+class DistanceType(OpenStrEnum):
+    local_listing_distances_regular = 'LOCAL_LISTING_DISTANCES_REGULAR'
+    local_listing_distances_specialty = 'LOCAL_LISTING_DISTANCES_SPECIALTY'
+    local_listing_distances_non_subscription = (
+        'LOCAL_LISTING_DISTANCES_NON_SUBSCRIPTION'
+    )
+
+
+class DurationEnum(OpenStrEnum):
+    gtc = 'GTC'
+    days_1 = 'DAYS_1'
+    days_3 = 'DAYS_3'
+    days_5 = 'DAYS_5'
+    days_7 = 'DAYS_7'
+    days_10 = 'DAYS_10'
+    days_30 = 'DAYS_30'
+    days_90 = 'DAYS_90'
+
+
+class ErrorParameter(EbayModel):
+    name: str | None = Field(None, description='The object of the error.')
+    value: str | None = Field(None, description='The value of the object.')
+
+
+class ErrorParameterV3(EbayModel):
+    name: str | None = Field(
+        None, description='Name of the entity that threw the error.'
+    )
+    value: str | None = Field(None, description='A description of the error.')
+
+
+class ExtendedProducerResponsibilityEnum(OpenStrEnum):
+    eco_participation_fee = 'ECO_PARTICIPATION_FEE'
+    take_back_policy = 'TAKE_BACK_POLICY'
+    repair_score = 'REPAIR_SCORE'
+
+
+class GenericUsageEnum(OpenStrEnum):
+    optional = 'OPTIONAL'
+    recommended = 'RECOMMENDED'
+    required = 'REQUIRED'
+
+
+class GeographicExposureEnum(OpenStrEnum):
+    national = 'National'
+    local_only = 'LocalOnly'
+    local_optional = 'LocalOptional'
+
+
+class HazardStatement(EbayModel):
+    statement_id: str | None = Field(
+        None,
+        alias='statementId',
+        description='The identifier of the statement. For sample values, see Hazard statement sample values .',
+    )
+    statement_description: str | None = Field(
+        None,
+        alias='statementDescription',
+        description='The description of the statement localized to the default language of the marketplace. For sample values, see Hazard statement sample values .',
+    )
+
+
+class ItemConditionDescriptorValueConstraint(EbayModel):
+    applicable_to_condition_descriptor_id: str | None = Field(
+        None,
+        alias='applicableToConditionDescriptorId',
+        description='This string is returned if the corresponding condition descriptor value requires an associated condition descriptor that must also be specified in a listing. The condition descriptor ID for the associated condition descriptors is returned here.',
+    )
+    applicable_to_condition_descriptor_value_ids: list[str] | None = Field(
+        None,
+        alias='applicableToConditionDescriptorValueIds',
+        description='This array is returned if the corresponding condition descriptor value is required for one or more associated condition descriptor values that must also be specified in a listing. The condition descriptor values IDs for the associated condition descriptor values are returned here.',
+    )
+
+
+class ListingStructurePolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The category ID to which the listing-structure policy applies.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='A value that indicates the root node of the category tree used for the response set. Each marketplace is based on a category tree whose root node is indicated by this unique category ID value. All category policy information returned by this call pertains to the categories included below this root node of the tree.',
+    )
+    variations_supported: bool | None = Field(
+        None,
+        alias='variationsSupported',
+        description='This flag denotes whether or not the associated category supports listings with item variations. If set to true , the category does support item variations.',
+    )
+
+
+class ListingTypeEnum(OpenStrEnum):
+    auction = 'AUCTION'
+    ad_type = 'AD_TYPE'
+    personal_offer = 'PERSONAL_OFFER'
+    fixed_price_item = 'FIXED_PRICE_ITEM'
+    lead_generation = 'LEAD_GENERATION'
+
+
+class LocalListingDistance(EbayModel):
+    distances: list[int] | None = Field(
+        None,
+        description='This array indicates the radius (in miles) of the selling area for Local Market Vehicle listings.',
+    )
+    distance_type: DistanceType | None = Field(
+        None,
+        alias='distanceType',
+        description='This enumerated value indicates the type of local listing distances, such as non-subscription or regular, for items listed by sellers.',
+    )
+
+
+class MarketplaceIdEnum(OpenStrEnum):
+    ebay_us = 'EBAY_US'
+    ebay_ca = 'EBAY_CA'
+    ebay_gb = 'EBAY_GB'
+    ebay_au = 'EBAY_AU'
+    ebay_at = 'EBAY_AT'
+    ebay_be = 'EBAY_BE'
+    ebay_de = 'EBAY_DE'
+    ebay_it = 'EBAY_IT'
+    ebay_nl = 'EBAY_NL'
+    ebay_es = 'EBAY_ES'
+    ebay_ch = 'EBAY_CH'
+    ebay_tw = 'EBAY_TW'
+    ebay_cz = 'EBAY_CZ'
+    ebay_dk = 'EBAY_DK'
+    ebay_fi = 'EBAY_FI'
+    ebay_fr = 'EBAY_FR'
+    ebay_gr = 'EBAY_GR'
+    ebay_hk = 'EBAY_HK'
+    ebay_hu = 'EBAY_HU'
+    ebay_in = 'EBAY_IN'
+    ebay_id = 'EBAY_ID'
+    ebay_ie = 'EBAY_IE'
+    ebay_il = 'EBAY_IL'
+    ebay_my = 'EBAY_MY'
+    ebay_nz = 'EBAY_NZ'
+    ebay_no = 'EBAY_NO'
+    ebay_ph = 'EBAY_PH'
+    ebay_pl = 'EBAY_PL'
+    ebay_pt = 'EBAY_PT'
+    ebay_pr = 'EBAY_PR'
+    ebay_ru = 'EBAY_RU'
+    ebay_sg = 'EBAY_SG'
+    ebay_za = 'EBAY_ZA'
+    ebay_se = 'EBAY_SE'
+    ebay_th = 'EBAY_TH'
+    ebay_vn = 'EBAY_VN'
+    ebay_cn = 'EBAY_CN'
+    ebay_jp = 'EBAY_JP'
+    ebay_pe = 'EBAY_PE'
+    ebay_half_us = 'EBAY_HALF_US'
+    ebay_motors_us = 'EBAY_MOTORS_US'
+
+
+class ModeEnum(OpenStrEnum):
+    selection_only = 'SELECTION_ONLY'
+    free_text = 'FREE_TEXT'
+
+
+class MotorsListingPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    deposit_supported: bool | None = Field(
+        None,
+        alias='depositSupported',
+        description='This field is returned as true if the corresponding category supports the use of a deposit/down payment on a motor vehicle listing. In an AddItem call, the seller can configure a down payment for a motor vehicle listing using the PaymentDetails container.',
+    )
+    ebay_motors_pro_ad_format_enabled: AdFormatEnabledEnum | None = Field(
+        None,
+        alias='ebayMotorsProAdFormatEnabled',
+        description='Indicates whether or not eBay Motors Pro sellers can use classified ads in this category to sell their vehicles. This element is applicable for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_auto_accept_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProAutoAcceptEnabled',
+        description='Indicates whether or not the category supports the Best Offer Auto Accept feature for eBay Motors Pro listings. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_auto_decline_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProAutoDeclineEnabled',
+        description='Indicates whether or not the category allows auto-decline for Best Offers for eBay Motors Classified Ad listings. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_best_offer_enabled: ClassifiedAdBestOfferEnabledEnum | None = Field(
+        None,
+        alias='ebayMotorsProBestOfferEnabled',
+        description='This enumerated value indicates whether or not Best Offer features are supported for eBay Motors Classified Ad listings in this category. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_company_name_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProCompanyNameEnabled',
+        description="Indicates whether this category supports including the company name in the seller's contact information. This element is for eBay Motors Pro users.",
+    )
+    ebay_motors_pro_contact_by_address_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProContactByAddressEnabled',
+        description="Indicates whether this category supports including the address in the seller's contact information. This element is for eBay Motors Pro users.",
+    )
+    ebay_motors_pro_contact_by_email_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProContactByEmailEnabled',
+        description="Indicates whether this category supports including an email address in the seller's contact information. This element is for eBay Motors Pro users.",
+    )
+    ebay_motors_pro_contact_by_phone_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProContactByPhoneEnabled',
+        description="Indicates whether this category supports including the telephone in the seller's contact information. This element is for eBay Motors Pro users.",
+    )
+    ebay_motors_pro_counter_offer_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProCounterOfferEnabled',
+        description='Indicates whether counter offers are allowed on Best Offers for this category in an eBay Motors Classified Ad listing. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_payment_method_check_out_enabled: (
+        ClassifiedAdPaymentMethodEnabledEnum | None
+    ) = Field(
+        None,
+        alias='ebayMotorsProPaymentMethodCheckOutEnabled',
+        description='This enumerated value indicates whether this category supports that the payment method should be displayed to the user for this category in an eBay Motors Classified Ad listing. Even if enabled, checkout may or may not be enabled. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_phone_count: int | None = Field(
+        None,
+        alias='ebayMotorsProPhoneCount',
+        description='Indicates the number of phone numbers that can be included through contact information for this category. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_seller_contact_details_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProSellerContactDetailsEnabled',
+        description='Indicates whether this category allows seller-level contact information for eBay Motors Classified Ad listings. A value of true means seller-level contact information is available for Classified Ad listings. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_shipping_method_enabled: bool | None = Field(
+        None,
+        alias='ebayMotorsProShippingMethodEnabled',
+        description='Indicates if shipping options should be displayed to the user for this category in an eBay Motors Classified Ad listing. This element is for eBay Motors Pro users.',
+    )
+    ebay_motors_pro_street_count: int | None = Field(
+        None,
+        alias='ebayMotorsProStreetCount',
+        description='This field indicates the number of street addresses allowed in contact information for this category. This element is for eBay Motors Pro users.',
+    )
+    epid_supported: bool | None = Field(
+        None,
+        alias='epidSupported',
+        description='If returned as true , this indicates the category supports the use of an eBay Product ID (e.g. ePID) to identify which motorcycles and/or scooters are compatible with a motor vehicle part or accessory. ePIDs can only be used to identify motorcycles and scooters on the Germany and UK sites.',
+    )
+    k_type_supported: bool | None = Field(
+        None,
+        alias='kTypeSupported',
+        description='This field indicates whether or not the category supports the use of a K type to identify the cars and trucks compatible with a motor vehicle part or accessory. Only the AU, DE, ES, FR, IT, and UK marketplaces support the use of K types. See Compatibility by K type for more information',
+    )
+    local_listing_distances: list[LocalListingDistance] | None = Field(
+        None,
+        alias='localListingDistances',
+        description="This array shows the supported distances (in miles) for different types of Local Market subscription types in this category. Motor vehicle listings will be shown to buyers located within these proximities of the vehicle's location.",
+    )
+    local_market_ad_format_enabled: AdFormatEnabledEnum | None = Field(
+        None,
+        alias='localMarketAdFormatEnabled',
+        description='Specifies whether this category supports Motor Local Market Classified Ad listings.',
+    )
+    local_market_auto_accept_enabled: bool | None = Field(
+        None,
+        alias='localMarketAutoAcceptEnabled',
+        description='Specifies whether this category supports auto-accept for Best Offers for Motors Local Market Classified Ads.',
+    )
+    local_market_auto_decline_enabled: bool | None = Field(
+        None,
+        alias='localMarketAutoDeclineEnabled',
+        description='Specifies whether this category supports auto-decline for Best Offers for Motors Local Market Classified Ads.',
+    )
+    local_market_best_offer_enabled: ClassifiedAdBestOfferEnabledEnum | None = Field(
+        None,
+        alias='localMarketBestOfferEnabled',
+        description='Indicates if Best Offer is enabled/required for Motors Local Market Classified Ad listings in this category.',
+    )
+    local_market_company_name_enabled: bool | None = Field(
+        None,
+        alias='localMarketCompanyNameEnabled',
+        description="Indicates whether the category supports the seller's company name being specified when using Motors Local Market classified ads.",
+    )
+    local_market_contact_by_address_enabled: bool | None = Field(
+        None,
+        alias='localMarketContactByAddressEnabled',
+        description="Indicates whether this category supports including the address in the seller's contact information.",
+    )
+    local_market_contact_by_email_enabled: bool | None = Field(
+        None,
+        alias='localMarketContactByEmailEnabled',
+        description="Indicates whether the category supports including an email address in the seller's contact information.",
+    )
+    local_market_contact_by_phone_enabled: bool | None = Field(
+        None,
+        alias='localMarketContactByPhoneEnabled',
+        description="Indicates whether this category supports including the telephone in the seller's contact information.",
+    )
+    local_market_counter_offer_enabled: bool | None = Field(
+        None,
+        alias='localMarketCounterOfferEnabled',
+        description='Indicates whether counter offers are allowed on Best Offers for this category for Motors Local Market Classified Ad listings.',
+    )
+    local_market_non_subscription: bool | None = Field(
+        None,
+        alias='localMarketNonSubscription',
+        description='Indicates whether the category supports a seller creating a Motors Local Market listing without a subscription. This feature is only available to licensed vehicle dealers.',
+    )
+    local_market_payment_method_check_out_enabled: (
+        ClassifiedAdPaymentMethodEnabledEnum | None
+    ) = Field(
+        None,
+        alias='localMarketPaymentMethodCheckOutEnabled',
+        description='Indicates if the payment method should be displayed to the user for this category in an Motors Local Market Classified Ad listing. Even if enabled, checkout may or may not be enabled.',
+    )
+    local_market_phone_count: int | None = Field(
+        None,
+        alias='localMarketPhoneCount',
+        description='Indicates the number of phone numbers that can be included through contact information for this category.',
+    )
+    local_market_premium_subscription: bool | None = Field(
+        None,
+        alias='localMarketPremiumSubscription',
+        description='Indicates whether the category supports the Premium level subscription Motors Local Market listings. This feature is only available to licensed vehicle dealers.',
+    )
+    local_market_regular_subscription: bool | None = Field(
+        None,
+        alias='localMarketRegularSubscription',
+        description='Indicates whether the category supports the Regular level subscription to Motors Local Market listings. This feature is only available to licensed vehicle dealers.',
+    )
+    local_market_seller_contact_details_enabled: bool | None = Field(
+        None,
+        alias='localMarketSellerContactDetailsEnabled',
+        description='Specifies the whether this category allows seller-level contact information for Motors Local Market Classified Ad listings.',
+    )
+    local_market_shipping_method_enabled: bool | None = Field(
+        None,
+        alias='localMarketShippingMethodEnabled',
+        description='Indicates if shipping methods should be displayed to the user for this category in an Motors Local Market Classified Ad listing. Even if enabled, checkout may or may not be enabled.',
+    )
+    local_market_speciality_subscription: bool | None = Field(
+        None,
+        alias='localMarketSpecialitySubscription',
+        description='Indicates whether the category supports the Specialty level subscription to Motors Local Market listings. This feature is only available to licensed vehicle dealers.',
+    )
+    local_market_street_count: int | None = Field(
+        None,
+        alias='localMarketStreetCount',
+        description="Indicates which address option is enabled for the seller's contact information.",
+    )
+    max_granular_fitment_count: int | None = Field(
+        None,
+        alias='maxGranularFitmentCount',
+        description='Indicates the maximum number of compatible applications allowed per item when adding or revising items with compatibilities provided at the most detailed granularity. For example, in Car and Truck Parts on the US site, the most granular application would include Year, Make, Model, Trim, and Engine.',
+    )
+    max_item_compatibility: int | None = Field(
+        None,
+        alias='maxItemCompatibility',
+        description='Indicates the maximum number of compatible applications allowed per item when adding or revising items. This is relevant for specifying parts compatibility by application manually only. See Specify parts compatibility manually and Managing product compatibility for more information.',
+    )
+    min_item_compatibility: int | None = Field(
+        None,
+        alias='minItemCompatibility',
+        description='Indicates the minimum number of required compatible applications for listing items. A value of 0 indicates it is not mandatory to specify parts compatibilities when listing.',
+    )
+    non_subscription: GeographicExposureEnum | None = Field(
+        None,
+        alias='nonSubscription',
+        description='The value in this field indicates whether the category supports Motors Local Market listings if the seller does not have a vehicle subscription.',
+    )
+    premium_subscription: GeographicExposureEnum | None = Field(
+        None,
+        alias='premiumSubscription',
+        description='The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Premium vehicle subscription.',
+    )
+    regular_subscription: GeographicExposureEnum | None = Field(
+        None,
+        alias='regularSubscription',
+        description='The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Regular vehicle subscription.',
+    )
+    seller_provided_title_supported: bool | None = Field(
+        None,
+        alias='sellerProvidedTitleSupported',
+        description="This field is returned as true if the corresponding category supports the use of a seller-provided title for a motor vehicle listing on the US or Canada Motors marketplaces. A seller-provided title is a descriptive title, given by the seller, that appears below eBay's pre-filled listing title for the motor vehicle.",
+    )
+    speciality_subscription: GeographicExposureEnum | None = Field(
+        None,
+        alias='specialitySubscription',
+        description='The value in this field indicates whether the category supports Motors Local Market listings if the seller has a Specialty vehicle subscription.',
+    )
+    vin_supported: bool | None = Field(
+        None,
+        alias='vinSupported',
+        description='Indicates if Vehicle Identification Number is supported.',
+    )
+    vrm_supported: bool | None = Field(
+        None,
+        alias='vrmSupported',
+        description='Indicates if Vehicle Registration Mark is supported.',
+    )
+
+
+class NegotiatedPricePolicy(EbayModel):
+    best_offer_auto_accept_enabled: bool | None = Field(
+        None,
+        alias='bestOfferAutoAcceptEnabled',
+        description='This flag denotes whether or not the category supports the setting of a price at which best offers are automatically accepted. If set to true , the category does support the setting of an automatic price for best-offers.',
+    )
+    best_offer_auto_decline_enabled: bool | None = Field(
+        None,
+        alias='bestOfferAutoDeclineEnabled',
+        description='This flag denotes whether or not the category supports the setting of an auto-decline price for best offers. If set to true , the category does support the setting of an automatic-decline price for best-offers.',
+    )
+    best_offer_counter_enabled: bool | None = Field(
+        None,
+        alias='bestOfferCounterEnabled',
+        description='This flag denotes whether or not the category supports the setting for an automatic counter-offer on best offers. If set to true , the category does support the setting of an automatic counter-offer price for best-offers.',
+    )
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The category ID to which the negotiated-price policies apply.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='A value that indicates the root node of the category tree used for the response set. Each marketplace is based on a category tree whose root node is indicated by this unique category ID value. All category policy information returned by this call pertains to the categories included below this root node of the tree.',
+    )
+
+
+class PackageLimits(EbayModel):
+    dimension_unit: str | None = Field(
+        None,
+        alias='dimensionUnit',
+        description='Unit of dimensional measurement, for example INCH or CENTIMETER .',
+    )
+    max_girth: float | None = Field(
+        None,
+        alias='maxGirth',
+        description='The maximum girth allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    max_height: float | None = Field(
+        None,
+        alias='maxHeight',
+        description='The maximum height allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    max_length: float | None = Field(
+        None,
+        alias='maxLength',
+        description='The maximum length allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    max_weight: float | None = Field(
+        None,
+        alias='maxWeight',
+        description='The maximum weight allowed for a package shipped through the corresponding shipping service, as measured in units of weightUnit .',
+    )
+    max_width: float | None = Field(
+        None,
+        alias='maxWidth',
+        description='The maximum width allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    min_girth: float | None = Field(
+        None,
+        alias='minGirth',
+        description='The minimum girth allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    min_height: float | None = Field(
+        None,
+        alias='minHeight',
+        description='The minimum height allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    min_length: float | None = Field(
+        None,
+        alias='minLength',
+        description='The minimum length allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    min_weight: float | None = Field(
+        None,
+        alias='minWeight',
+        description='The minimum weight allowed for a package shipped through the corresponding shipping service, as measured in units of weightUnit .',
+    )
+    min_width: float | None = Field(
+        None,
+        alias='minWidth',
+        description='The minimum width allowed for a package shipped through the corresponding shipping service, as measured in units of dimensionUnit .',
+    )
+    weight_unit: str | None = Field(
+        None,
+        alias='weightUnit',
+        description='Unit of weight measurement, for example KILOGRAM or OUNCE .',
+    )
+
+
+class Pagination(EbayModel):
+    count: int | None = Field(
+        None,
+        description='The number of results showing on the current page of results.',
+    )
+    limit: int | None = Field(
+        None,
+        description='The max number of entries that can be returned on a single page.',
+    )
+    offset: int | None = Field(
+        None,
+        description='The number of items that will be skipped in the result set before returning the first item in the paginated response.',
+    )
+    total: int | None = Field(
+        None, description='The total number of results in a result set.'
+    )
+
+
+class PaginationInput(EbayModel):
+    limit: int | None = Field(
+        None,
+        description='The max number of items, from the current result set, returned on a single page. Note: For getProductCompatibilities , the max value is 100. If no limit is specified, this field defaults to the max value.',
+    )
+    offset: int | None = Field(
+        None,
+        description='The number of items that will be skipped in the result set before returning the first item in the paginated response. Combine offset with limit to control the items returned in the response. For example, if you supply an offset of 10 and a limit of 20, the first page of the response contains items 11-30 from the complete result set. Default: 0',
+    )
+
+
+class PaymentEnum(OpenStrEnum):
+    cash_on_pickup = 'CASH_ON_PICKUP'
+    payment_see_description = 'PAYMENT_SEE_DESCRIPTION'
+    mocc = 'MOCC'
+    personal_check = 'PERSONAL_CHECK'
+    other = 'OTHER'
+
+
+class Pictogram(EbayModel):
+    pictogram_id: str | None = Field(
+        None,
+        alias='pictogramId',
+        description='The identifier of the pictogram. For sample values, see Pictogram sample values .',
+    )
+    pictogram_description: str | None = Field(
+        None,
+        alias='pictogramDescription',
+        description='The description of the pictogram localized to the default language of the marketplace. For sample values, see Pictogram sample values .',
+    )
+    pictogram_url: str | None = Field(
+        None, alias='pictogramUrl', description='The URL of the pictogram.'
+    )
+
+
+class ProductIdentiferEnabledEnum(OpenStrEnum):
+    disabled = 'DISABLED'
+    enabled = 'ENABLED'
+    required = 'REQUIRED'
+
+
+class ProductIdentifier(EbayModel):
+    ean: str | None = Field(
+        None,
+        description='The EAN of the item, if applicable. EAN is the European Article Number, a barcode standard for retail product labeling primarily used outside of North America.',
+    )
+    epid: str | None = Field(
+        None,
+        description='The ePID (eBay Product Identifier) of the item, if applicable. ePID is a unique identifier used by eBay to track products in its catalog. Use the getProduct method of the Catalog API to retrieve the ePID of an item.',
+    )
+    isbn: str | None = Field(
+        None,
+        description='The ISBN of the item, if applicable. ISBN is the International Standard Book Number, a unique identifier for books.',
+    )
+    product_id: str | None = Field(
+        None,
+        alias='productId',
+        description='The product ID of the item, if applicable. The product ID is a general term for a unique identifier assigned to a product.',
+    )
+    upc: str | None = Field(
+        None,
+        description='The UPC of the item, if applicable. UPC stands for Universal Product Code, a unique identifier for products, primarily in North America.',
+    )
+
+
+class ProductSafetyLabelPictogram(EbayModel):
+    pictogram_description: str | None = Field(
+        None,
+        alias='pictogramDescription',
+        description='The description of the pictogram localized to the default language of the marketplace.',
+    )
+    pictogram_id: str | None = Field(
+        None, alias='pictogramId', description='The identifier of the pictogram.'
+    )
+    pictogram_url: str | None = Field(
+        None, alias='pictogramUrl', description='The URL of the pictogram.'
+    )
+
+
+class ProductSafetyLabelStatement(EbayModel):
+    statement_description: str | None = Field(
+        None,
+        alias='statementDescription',
+        description='The description of the statement localized to the default language of the marketplace.',
+    )
+    statement_id: str | None = Field(
+        None, alias='statementId', description='The identifier of the statement.'
+    )
+
+
+class ProductSafetyLabelsResponse(EbayModel):
+    pictograms: list[ProductSafetyLabelPictogram] | None = Field(
+        None,
+        description='This array contains a list of pictograms of product safety labels for the specified marketplace.',
+    )
+    statements: list[ProductSafetyLabelStatement] | None = Field(
+        None,
+        description='This array contains available product safety labels statements for the specified marketplace.',
+    )
+
+
+class PropertyFilterInner(EbayModel):
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description="The name of the property being described. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category. Use the getCompatibilityPropertyNames method to retrieve valid property names for a specified category.",
+    )
+    property_value: str | None = Field(
+        None,
+        alias='propertyValue',
+        description='The value for the property specified in the properyName field. For example, if the propertyName is Make , then the propertyValue will be the specific make of the vehicle, such as Toyota . Use the getCompatibilityPropertyValues to retrieve valid property values associated with a specified property name.',
+    )
+    unit_of_measurement: str | None = Field(
+        None,
+        alias='unitOfMeasurement',
+        description='The unit of measurement of the property being described, if applicable.',
+    )
+    url: str | None = Field(
+        None,
+        description='The URL associated with the property being described, if applicable.',
+    )
+
+
+class PropertyNamesRequest(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which to retrieve compatibility property names. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility. Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility.',
+    )
+    dataset: list[str] | None = Field(
+        None,
+        description='This array defines the properties that will be returned for the compatibility-enabled category. For example, if you specify Searchable , the compatibility details will contain properties that can be used to search for products, such as make or model. Valid values: DisplayableProductDetails : Properties for use in a user interface to describe products.',
+    )
+
+
+class PropertyNamesResponsePropertyNameMetadata(EbayModel):
+    display_sequence: int | None = Field(
+        None,
+        alias='displaySequence',
+        description='The numeric value indicating the ordering position of the property.',
+    )
+
+
+class PropertyNamesResponsePropertyNames(EbayModel):
+    property_display_name: str | None = Field(
+        None,
+        alias='propertyDisplayName',
+        description='The display name of a property. This is the localized name of the compatible property.',
+    )
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description='The canonical name of a property. This value is used as part of the name-value pairs used to specify compatibility.',
+    )
+    property_name_metadata: PropertyNamesResponsePropertyNameMetadata | None = Field(
+        None, alias='propertyNameMetadata', description='The metadata for a property.'
+    )
+
+
+class PropertyValues(EbayModel):
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description="The name of the property. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category.",
+    )
+    property_value: str | None = Field(
+        None,
+        alias='propertyValue',
+        description='The value for the property specified in the properyName field. For example, if the propertyName is make , then the propertyValue will be the specific make of the vehicle, such as Toyota .',
+    )
+
+
+class PropertyValuesRequest(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which to retrieve compatibility property values. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility. Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility.',
+    )
+    property_filters: list[PropertyFilterInner] | None = Field(
+        None,
+        alias='propertyFilters',
+        description='This array can be used to specify the compatibility properties used limit the result set. Only values associated with the specified name-value pairs will be returned in the response. For example, if the propertyName is set to Make and the propertyValue is set to Honda , only compatible Honda vehicles will be returned.',
+    )
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description="This field specifies the name of the property for which to retrieve associated property values. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category. Use the getCompatibilityPropertyNames method to retrieve valid property names for a specified category.",
+    )
+    sort_order: str | None = Field(
+        None,
+        alias='sortOrder',
+        description='This field specifies the sort order for the property values in the result set. Valid values: Ascending Descending Note: If no search order is specified, values are sorted in ascending order.',
+    )
+
+
+class PropertyValuesResponse(EbayModel):
+    metadata_version: str | None = Field(
+        None,
+        alias='metadataVersion',
+        description='The version number of the metadata. This version is upticked whenever there are compatibility name changes for the specified marketplace.',
+    )
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description='The name of the property specified in the request.',
+    )
+    property_values: list[str] | None = Field(
+        None,
+        alias='propertyValues',
+        description='This array specifies the property values associated with the specified propertyName , in the specified category.',
+    )
+
+
+class RefundMethodEnum(OpenStrEnum):
+    money_back = 'MONEY_BACK'
+
+
+class RegulatoryAttributeEnum(OpenStrEnum):
+    hazmat = 'HAZMAT'
+    energy_efficiency = 'ENERGY_EFFICIENCY'
+    manufacturer_contact = 'MANUFACTURER_CONTACT'
+    product_safety = 'PRODUCT_SAFETY'
+
+
+class ReturnMethodEnum(OpenStrEnum):
+    replacement = 'REPLACEMENT'
+
+
+class ReturnShippingCostPayerEnum(OpenStrEnum):
+    buyer = 'BUYER'
+    seller = 'SELLER'
+
+
+class SalesTaxJurisdiction(EbayModel):
+    sales_tax_jurisdiction_id: str | None = Field(
+        None,
+        alias='salesTaxJurisdictionId',
+        description='The unique ID for a sales-tax jurisdiction. Important! When countryCode is set to US , IDs for all 50 states, Washington, DC, and all US territories will be returned. However, the only salesTaxJurisdictionId values currently supported are: AS (American Samoa) GU (Guam MP Northern Mariana Islands PW (Palau) VI (US Virgin Islands)',
+    )
+
+
+class SalesTaxJurisdictions(EbayModel):
+    sales_tax_jurisdictions: list[SalesTaxJurisdiction] | None = Field(
+        None,
+        alias='salesTaxJurisdictions',
+        description='A list of sales-tax jurisdictions.',
+    )
+
+
+class ShippingCarrier(EbayModel):
+    description: str | None = Field(
+        None,
+        description='The localized description of the shipping carrier, such as UPS , FedEx , and USPS .',
+    )
+    shipping_carrier: str | None = Field(
+        None,
+        alias='shippingCarrier',
+        description='An enumerated value describing the shipping carrier returned, for example, UPS , FedEx , and USPS . These values are needed when providing shipment tracking information for each specific shipping carrier.',
+    )
+
+
+class ShippingCarrierResponse(EbayModel):
+    shipping_carriers: list[ShippingCarrier] | None = Field(
+        None,
+        alias='shippingCarriers',
+        description='A list of shipping carriers available for the marketplace.',
+    )
+
+
+class ShippingExcludeLocation(EbayModel):
+    description: str | None = Field(None, description='The localized location name.')
+    location: str | None = Field(
+        None,
+        description='The location or region to be excluded. Countries are returned through ISO 3166 codes . This field may also include continents and other larger geographical regions (for example, the Middle East, Southeast Asia), as well as domestic/special locations (like APO/FPO, PO Box, Alaska/Hawaii).',
+    )
+    region: str | None = Field(
+        None,
+        description='The region of the excluded shipping area specified, such as: Africa Americas Asia Central America and Caribbean Europe Middle East North America Oceania South America Southeast Asia',
+    )
+
+
+class ShippingExcludeLocationResponse(EbayModel):
+    exclude_shipping_locations: list[ShippingExcludeLocation] | None = Field(
+        None,
+        alias='excludeShippingLocations',
+        description='The complete list of geographical regions, countries, domestic areas, and special locations for the specified eBay marketplace that the seller has designated as excluded shipping locations.',
+    )
+
+
+class ShippingHandlingTime(EbayModel):
+    description: str | None = Field(
+        None, description='The localized description of the maximum handling time.'
+    )
+    extended_handling: bool | None = Field(
+        None,
+        alias='extendedHandling',
+        description='This field is only returned if its value is true . If returned, it indicates that the corresponding handling time is considered extended handling for the marketplace. Extended handling times may be used for freight shipping, but should generally be avoided if possible, as they might adversely affect the buying decisions of potential customers.',
+    )
+    max_handling_time: int | None = Field(
+        None,
+        alias='maxHandlingTime',
+        description="The integer value returned in this field indicates the maximum number of business days that the eBay site allows as a seller's handling time measured from when the buyer pays for the order. For example, if the maxHandlingTime value is set to 1 and a buyer pays for the order on a Wednesday, the seller would have to ship the item by the next day (Thursday).",
+    )
+
+
+class ShippingHandlingTimeResponse(EbayModel):
+    handling_times: list[ShippingHandlingTime] | None = Field(
+        None,
+        alias='handlingTimes',
+        description='A list of supported handling times for the marketplace.',
+    )
+
+
+class ShippingLocation(EbayModel):
+    description: str | None = Field(None, description='The localized location name.')
+    shipping_location: str | None = Field(
+        None,
+        alias='shippingLocation',
+        description='The name or abbreviation of the shipping location or region. Countries are returned through ISO 3166 codes . This field may also include continents and other larger geographical regions (for example, the Middle East, Southeast Asia), as well as domestic/special locations (like APO/FPO, PO Box, Alaska/Hawaii).',
+    )
+
+
+class ShippingLocationResponse(EbayModel):
+    shipping_locations: list[ShippingLocation] | None = Field(
+        None,
+        alias='shippingLocations',
+        description='The complete list of geographical regions, countries, domestic areas, and special locations for the specified eBay marketplace that can be set as shipping locations.',
+    )
+
+
+class ShippingService(EbayModel):
+    description: str | None = Field(
+        None,
+        description='This field returns the localized name of the shipping service.',
+    )
+    international_service: bool | None = Field(
+        None,
+        alias='internationalService',
+        description='A value of true indicates that the shipping service is international. An international shipping service option is required if an item is being shipped from one country (origin) to another (destination).',
+    )
+    max_shipping_time: int | None = Field(
+        None,
+        alias='maxShippingTime',
+        description='This value indicates the maximum number of business days that it takes the shippingCarrier to ship an item using the corresponding shippingService .',
+    )
+    min_shipping_time: int | None = Field(
+        None,
+        alias='minShippingTime',
+        description='This value indicates the minimum number of business days that it takes the shippingCarrier to ship an item using the corresponding shippingService .',
+    )
+    package_limits: PackageLimits | None = Field(
+        None,
+        alias='packageLimits',
+        description='This container provides name-value pairs that specify physical constraints and measurement units of packages for the shippingCarrier and the corresponding shippingService . An empty container is returned if the shipping service does not have any package limits defined.',
+    )
+    shipping_carrier: str | None = Field(
+        None,
+        alias='shippingCarrier',
+        description='The code for the shipping carrier returned, for example, UPS , FedEx , and USPS .',
+    )
+    shipping_category: str | None = Field(
+        None,
+        alias='shippingCategory',
+        description='The shipping category of the shipping service including: ECONOMY , STANDARD , EXPEDITED , ONE_DAY , PICKUP , and other similar categories.',
+    )
+    shipping_cost_types: list[str] | None = Field(
+        None,
+        alias='shippingCostTypes',
+        description='A list of shipping cost types that this shipping service option supports. For example, FLAT_RATE , CALCULATED , and FREIGHT .',
+    )
+    shipping_service: str | None = Field(
+        None,
+        alias='shippingService',
+        description='The name of the shipping service. The shipping service named here can only be used in listings or in business policies if validForSellingFlow is true . The value returned in this field is used in listing APIs and business policies to set the shipping service.',
+    )
+    valid_for_selling_flow: bool | None = Field(
+        None,
+        alias='validForSellingFlow',
+        description='A value of true indicates that the shippingService can be set as an available shipping service in the listing or through the fulfillment business policy.',
+    )
+
+
+class ShippingServiceResponse(EbayModel):
+    shipping_services: list[ShippingService] | None = Field(
+        None,
+        alias='shippingServices',
+        description='A complete list of shipping service options that can be used on the marketplace for shipping items.',
+    )
+
+
+class SignalWord(EbayModel):
+    signal_word_id: str | None = Field(
+        None,
+        alias='signalWordId',
+        description='The identifier of the signal word. For more information, see Signal word information .',
+    )
+    signal_word_description: str | None = Field(
+        None,
+        alias='signalWordDescription',
+        description='The description of the signal word localized to the default language of the marketplace. For more information, see Signal word information .',
+    )
+
+
+class SiteVisibilityPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    cross_border_trade_australia_enabled: bool | None = Field(
+        None,
+        alias='crossBorderTradeAustraliaEnabled',
+        description='If true , the category supports specifying that listings of a seller on the UK marketplace can pass in Australia as a value in a field to expose that item on the eBay Australia site (ebay.com.au). For more information, see Cross-border trading .',
+    )
+    cross_border_trade_gb_enabled: bool | None = Field(
+        None,
+        alias='crossBorderTradeGBEnabled',
+        description='If true , the category supports specifying that listings of a seller on the US or Canada marketplaces can pass in UK as a value in a field to expose that item on the eBay UK (ebay.co.uk) and eBay IE (ebay.ie) sites. For more information, see Cross-border trading .',
+    )
+    cross_border_trade_north_america_enabled: bool | None = Field(
+        None,
+        alias='crossBorderTradeNorthAmericaEnabled',
+        description='If true , the category supports specifying that listings of a seller on the US or Canada marketplaces can pass in North America as a value in a field to expose that item on the eBay US (ebay.com) and eBay Canada (ebay.ca) sites (English). For more information, see Cross-border trading .',
+    )
+
+
+class SortOrderProperties(EbayModel):
+    order: str | None = Field(
+        None,
+        description='Defines the order of the sort. Valid values : Ascending Descending',
+    )
+    property_name: str | None = Field(
+        None,
+        alias='propertyName',
+        description="The name of the searchable property to be used for sorting. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category.",
+    )
+
+
+class TimeDurationUnitEnum(OpenStrEnum):
+    year = 'YEAR'
+    month = 'MONTH'
+    day = 'DAY'
+    hour = 'HOUR'
+    calendar_day = 'CALENDAR_DAY'
+    business_day = 'BUSINESS_DAY'
+    minute = 'MINUTE'
+    second = 'SECOND'
+    millisecond = 'MILLISECOND'
+
+
+class UsageEnum(OpenStrEnum):
+    restricted = 'RESTRICTED'
+
+
+class Amount(EbayModel):
+    currency: CurrencyCodeEnum | None = Field(
+        None,
+        description='The three-letter ISO 4217 code representing the currency of the amount in the value field. Restriction: Only the currency of the marketplace is supported. For example, on the US marketplace the only currency supported is USD.',
+    )
+    value: str | None = Field(
+        None,
+        description='The monetary amount, in the currency specified by the currency field.',
+    )
+
+
+class AutomotivePartsCompatibilityPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The category ID to which the automotive parts compatibility policies apply.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='A value that indicates the root node of the category tree used for the response set. Each marketplace is based on a category tree whose root node is indicated by this unique category ID value. All category policy information returned by this call pertains to the categories included below this root node of the tree.',
+    )
+    compatibility_based_on: CompatibilityTypeEnum | None = Field(
+        None,
+        alias='compatibilityBasedOn',
+        description='Indicates whether the category supports parts compatibility by either ASSEMBLY or by SPECIFICATION . Note: Only categories returning the compatibilityBasedOn field support compatibility. Categories where all compatibility fields are missing, or where only compatibilityBasedOn is missing, should be considered as not supporting compatibility.',
+    )
+    compatible_vehicle_types: list[CompatibleVehicleTypeEnum] | None = Field(
+        None,
+        alias='compatibleVehicleTypes',
+        description='Indicates the compatibility classification of the part based on high-level vehicle types.',
+    )
+    max_number_of_compatible_vehicles: int | None = Field(
+        None,
+        alias='maxNumberOfCompatibleVehicles',
+        description='Specifies the maximum number of compatible vehicle-applications allowed per item.',
+    )
+
+
+class CategoryPolicy(EbayModel):
+    auto_pay_enabled: bool | None = Field(
+        None,
+        alias='autoPayEnabled',
+        description="If this field is returned as true , the corresponding category supports immediate payment for listings. The immediate payment feature is applicable to fixed-price listings, to auction listings with the 'Buy It Now' option enabled, and for a motor vehicle listing that requires an initial deposit.",
+    )
+    b2b_vat_enabled: bool | None = Field(
+        None,
+        alias='b2bVatEnabled',
+        description='If this field is returned as true , the corresponding category supports business-to-business (B2B) VAT listings. If this field is not present, the category does not have B2B VAT listings. This feature is applicable to the eBay Germany (DE), Austria (AT), and Switzerland (CH) sites only. This field is only returned when true (not returned when false).',
+    )
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    ean_support: ProductIdentiferEnabledEnum | None = Field(
+        None,
+        alias='eanSupport',
+        description='This enumerated value indicates whether or not European Article Numbers (EANs) are supported/required when listing products in the category.',
+    )
+    expired: bool | None = Field(
+        None,
+        description='If this field is returned as true , the corresponding category is no longer a valid eBay category on the site, and items may not be listed in this category. You can use the getExpiredCategories method (of the Taxonomy API ) to find the leaf category that replaced the expired category. This field is only returned when true (not returned when false).',
+    )
+    intangible_enabled: bool | None = Field(
+        None,
+        alias='intangibleEnabled',
+        description='If this field is returned as true , the category supports the listing of intangible goods or services.',
+    )
+    isbn_support: ProductIdentiferEnabledEnum | None = Field(
+        None,
+        alias='isbnSupport',
+        description='This enumerated value indicates whether or not International Standard Book Numbers (ISBNs) are supported/required when listing products in the specified category.',
+    )
+    lsd: bool | None = Field(
+        None,
+        description='If this field (Lot Size Disabled) is returned as true , the corresponding category does not support lot listings. A lot listing is a listing that features multiple related items that must be purchased by one buyer in one transaction. This field is only returned when true (not returned when false).',
+    )
+    minimum_reserve_price: float | None = Field(
+        None,
+        alias='minimumReservePrice',
+        description='Indicates the Minimum Reserve Price for an auction listing in this category. If there is no Minimum Reserve Price, a value of 0.0 is returned in this field.',
+    )
+    orpa: bool | None = Field(
+        None,
+        description="This field (Override Reserve Price Allowed) is returned as true if the eBay marketplace's default policy is to allow reserve prices for auction listings, but the corresponding category does not allow a reserve price. Note: This field is not returned if the marketplace does not permit reserve prices.",
+    )
+    orra: bool | None = Field(
+        None,
+        description='If this field (Override Reduce Reserve Allowed) is returned as true , the seller can reduce or remove a reserve price that had already been reduced for an active auction listing.',
+    )
+    payment_methods: list[PaymentEnum] | None = Field(
+        None,
+        alias='paymentMethods',
+        description='An array that indicates the acceptable offline payment methods that can be used when listing an item for sale in the corresponding category.',
+    )
+    reduce_reserve_allowed: bool | None = Field(
+        None,
+        alias='reduceReserveAllowed',
+        description="If this field (Reduce Reserve Allowed) is true , the corresponding leaf category allows the seller to reduce an item's reserve price. If false, this field is not returned in the response and the corresponding leaf category on the site do not normally allow sellers to reduce an item's reserve price. This field is only returned when true (not returned when false).",
+    )
+    reserve_price_allowed: bool | None = Field(
+        None,
+        alias='reservePriceAllowed',
+        description='This field indicates whether reserve prices are allowed for auction listings in this category. This field returns as true when the category supports reserve prices, or false if the eBay marketplace does not permit reserve prices or the category override blocks reserve prices ( orpa is true ).',
+    )
+    upc_support: ProductIdentiferEnabledEnum | None = Field(
+        None,
+        alias='upcSupport',
+        description='This enumerated value indicates whether or not the category on the specified eBay site supports the use of Universal Product Codes (UPCs) to help create a listing.',
+    )
+    value_category: bool | None = Field(
+        None,
+        alias='valueCategory',
+        description='When returned as true , this boolean indicates that the leaf category for the specified site is designated by eBay as a value category. Value categories can be used as a secondary category for a listing at no extra charge.',
+    )
+    virtual: bool | None = Field(
+        None,
+        description='If this field is returned as true , the corresponding category is an eBay virtual category, a category in which items may not be listed. This field is only returned when true (not returned when false).',
+    )
+
+
+class Compatibility(EbayModel):
+    compatibility_details: list[CompatibilityDetails] | None = Field(
+        None,
+        alias='compatibilityDetails',
+        description='This array returns a list of compatibility details associated with the specified property name(s).',
+    )
+
+
+class Currency(EbayModel):
+    code: CurrencyCodeEnum | None = Field(
+        None,
+        description='The three-letter ISO 4217 code returned. Restriction: Only the currency of the marketplace is supported. Examples: on the US marketplace, the only currency supported is the United States dollar, USD ; on the Canadian marketplace, the only currency supported is the Canadian dollar, CAD .',
+    )
+    description: str | None = Field(
+        None,
+        description='The description of the returned three-letter code. For example, if the code is USD , the description returned would be US Dollar .',
+    )
+
+
+class Error(EbayModel):
+    category: str | None = Field(None, description='Identifies the type of error.')
+    domain: str | None = Field(
+        None,
+        description='Name for the primary system where the error occurred. This is relevant for application errors.',
+    )
+    error_id: int | None = Field(
+        None, alias='errorId', description='A unique number to identify the error.'
+    )
+    input_ref_ids: list[str] | None = Field(
+        None,
+        alias='inputRefIds',
+        description='An array of request elements most closely associated to the error.',
+    )
+    long_message: str | None = Field(
+        None,
+        alias='longMessage',
+        description='A more detailed explanation of the error.',
+    )
+    message: str | None = Field(
+        None,
+        description="Information on how to correct the problem, in the end user's terms and language where applicable.",
+    )
+    output_ref_ids: list[str] | None = Field(
+        None,
+        alias='outputRefIds',
+        description='An array of request elements most closely associated to the error.',
+    )
+    parameters: list[ErrorParameter] | None = Field(
+        None,
+        description='An array of name/value pairs that describe details the error condition. These are useful when multiple errors are returned.',
+    )
+    subdomain: str | None = Field(
+        None,
+        description='Further helps indicate which subsystem the error is coming from. System subcategories include: Initialization, Serialization, Security, Monitoring, Rate Limiting, etc.',
+    )
+
+
+class ErrorDetailV3(EbayModel):
+    category: str | None = Field(
+        None,
+        description="The category type for this error or warning. It takes an ErrorCategory object which can have one of three values: Application : Indicates an exception or error occurred in the application code or at runtime. Examples include catching an exception in a service's business logic, system failures, or request errors from a dependency.",
+    )
+    domain: str | None = Field(
+        None, description='Name of the domain containing the service or application.'
+    )
+    error_id: int | None = Field(
+        None,
+        alias='errorId',
+        description='A positive integer that uniquely identifies the specific error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.',
+    )
+    input_ref_ids: list[str] | None = Field(
+        None,
+        alias='inputRefIds',
+        description="Identifies specific request elements associated with the error, if any. inputRefId's response is format specific. For JSON, use JSONPath notation.",
+    )
+    long_message: str | None = Field(
+        None,
+        alias='longMessage',
+        description='An expanded version of message that should be around 100-200 characters long, but is not required to be such.',
+    )
+    message: str | None = Field(
+        None,
+        description="An end user and app developer friendly device agnostic message. It explains what the error or warning is, and how to fix it (in a general sense). Its value is at most 50 characters long. If applicable, the value is localized in the end user's requested locale.",
+    )
+    output_ref_ids: list[str] | None = Field(
+        None,
+        alias='outputRefIds',
+        description='Identifies specific response elements associated with the error, if any. Path format is the same as inputRefId .',
+    )
+    parameters: list[ErrorParameterV3] | None = Field(
+        None,
+        description='This optional complex field type contains a list of one or more context-specific ErrorParameter objects, with each item in the list entry being a parameter (or input field name) that caused an error condition. Each ErrorParameter object consists of two fields, a name and a value .',
+    )
+    subdomain: str | None = Field(
+        None,
+        description="Name of the domain's subsystem or subdivision. For example, checkout is a subdomain in the buying domain.",
+    )
+
+
+class ExtendedProducerResponsibility(EbayModel):
+    enabled_for_variations: bool | None = Field(
+        None,
+        alias='enabledForVariations',
+        description='An indication of whether the attribute can be enabled for listing variations. If the value is true , the attribute may be specified at the variation level.',
+    )
+    name: ExtendedProducerResponsibilityEnum | None = Field(
+        None, description='The name of the attribute included in the policy.'
+    )
+    usage: GenericUsageEnum | None = Field(
+        None,
+        description='The usage guidelines for the attribute, in the specified marketplace.',
+    )
+
+
+class ExtendedProducerResponsibilityPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier for the category under which the policy applies.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier for the category tree under which the policy applies.',
+    )
+    supported_attributes: list[ExtendedProducerResponsibility] | None = Field(
+        None,
+        alias='supportedAttributes',
+        description='The details regarding the attributes included in the policy, such as their usage guidelines and whether they can be specified at the listing variation level.',
+    )
+
+
+class ExtendedProducerResponsibilityPolicyResponse(EbayModel):
+    extended_producer_responsibilities: (
+        list[ExtendedProducerResponsibilityPolicy] | None
+    ) = Field(
+        None,
+        alias='extendedProducerResponsibilities',
+        description='An array of response fields detailing the Extended Producer Responsibility policies supported for the specified marketplace.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None, description='A collection of warnings generated for the request.'
+    )
+
+
+class GetCurrenciesResponse(EbayModel):
+    default_currency: Currency | None = Field(
+        None,
+        alias='defaultCurrency',
+        description='This field specifies the default currency used by the marketplace.',
+    )
+    marketplace_id: MarketplaceIdEnum | None = Field(
+        None,
+        alias='marketplaceId',
+        description='The ID of the eBay marketplace to which the default currency applies.',
+    )
+
+
+class HazardousMaterialDetailsResponse(EbayModel):
+    signal_words: list[SignalWord] | None = Field(
+        None,
+        alias='signalWords',
+        description='This array contains available hazardous materials signal words for the specified marketplace.',
+    )
+    statements: list[HazardStatement] | None = Field(
+        None,
+        description='This array contains available hazardous materials hazard statements for the specified marketplace.',
+    )
+    pictograms: list[Pictogram] | None = Field(
+        None,
+        description='This array contains available hazardous materials hazard pictograms for the specified marketplace.',
+    )
+
+
+class ItemConditionDescriptorConstraint(EbayModel):
+    applicable_to_condition_descriptor_ids: list[str] | None = Field(
+        None,
+        alias='applicableToConditionDescriptorIds',
+        description='This array is returned if the corresponding condition descriptor requires that one or more other associated condition descriptors must also be specified in a listing. The condition descriptor IDs for the associated condition descriptors are returned here. For example, the Grade and Grader condition descriptors must always be specified together in a listing for Graded cards.',
+    )
+    cardinality: CardinalityEnum | None = Field(
+        None,
+        description='The value returned in this field indicates whether a condition descriptor can have a single value or multiple values.',
+    )
+    default_condition_descriptor_value_id: str | None = Field(
+        None,
+        alias='defaultConditionDescriptorValueId',
+        description='The default condition descriptor value that will be set if there are multiple values.',
+    )
+    max_length: int | None = Field(
+        None,
+        alias='maxLength',
+        description='The maximum characters allowed for a condition descriptor. This field is only returned/applicable for condition descriptors that allow free text for condition descriptor values.',
+    )
+    mode: ModeEnum | None = Field(
+        None,
+        description='The value returned in this field indicates whether the supported values for a condition descriptor are predefined or if the seller manually specified the value. Note: FREE_TEXT is currently only applicable to the Certification Number condition descriptor.',
+    )
+    usage: DescriptorUsageEnum | None = Field(
+        None,
+        description='This value indicates whether or not the condition descriptor is required for the item condition. Currently, this field is only returned if the condition descriptor is required for the item condition.',
+    )
+
+
+class ItemConditionDescriptorValue(EbayModel):
+    condition_descriptor_value_additional_help_text: list[str] | None = Field(
+        None,
+        alias='conditionDescriptorValueAdditionalHelpText',
+        description='Additional information about the the condition of the item that is not included in the conditionDescriptorValueHelpText field.',
+    )
+    condition_descriptor_value_constraints: (
+        list[ItemConditionDescriptorValueConstraint] | None
+    ) = Field(
+        None,
+        alias='conditionDescriptorValueConstraints',
+        description='The constraints on a condition descriptor value, such as which descriptor value IDs and Descriptor ID it is associated with.',
+    )
+    condition_descriptor_value_help_text: str | None = Field(
+        None,
+        alias='conditionDescriptorValueHelpText',
+        description='A detailed description of the condition descriptor value.',
+    )
+    condition_descriptor_value_id: str | None = Field(
+        None,
+        alias='conditionDescriptorValueId',
+        description='The unique identification number of a condition descriptor value associated with the conditionDescriptorValueName .',
+    )
+    condition_descriptor_value_name: str | None = Field(
+        None,
+        alias='conditionDescriptorValueName',
+        description='The human-readable label for the condition descriptor value associated with the conditionDescriptorValueID .',
+    )
+
+
+class ListingDuration(EbayModel):
+    duration_values: list[DurationEnum] | None = Field(
+        None,
+        alias='durationValues',
+        description='This array defines the supported time duration options available for the listing type.',
+    )
+    listing_type: ListingTypeEnum | None = Field(
+        None,
+        alias='listingType',
+        description='The enumerated value returned in this field indicates the listing type for the duration value(s).',
+    )
+
+
+class ListingStructurePolicyResponse(EbayModel):
+    listing_structure_policies: list[ListingStructurePolicy] | None = Field(
+        None,
+        alias='listingStructurePolicies',
+        description='Returns a list of category IDs plus a flag indicating whether or not each listed category supports item variations.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ListingTypePolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    digital_good_delivery_enabled: bool | None = Field(
+        None,
+        alias='digitalGoodDeliveryEnabled',
+        description="A true value in this field indicates that the leaf category supports the listing of items (such as gift cards) that can be delivered electronically via a download link or sent to a buyer's email address.",
+    )
+    listing_durations: list[ListingDuration] | None = Field(
+        None,
+        alias='listingDurations',
+        description='An array of eBay listing types and the supported durations for the corresponding leaf category. If a specific eBay listing type does not appear for a leaf category, it indicates that the category does not support that listing type.',
+    )
+    pickup_drop_off_enabled: bool | None = Field(
+        None,
+        alias='pickupDropOffEnabled',
+        description="A true value in this field indicates that items listed in the category (specified in the listingTypePolicies.categoryId field) may be enabled with the 'Click and Collect' feature. With the 'Click and Collect' feature, a buyer can purchase certain items on an eBay site and collect them at a local store. Buyers are notified by eBay once their items are available.",
+    )
+
+
+class MinimumListingPricePoliciesType(EbayModel):
+    description: str | None = Field(
+        None,
+        description='The description of the listing type for which the pricing data is intended, such as "Pricing for the auction-like listings".',
+    )
+    listing_type: ListingTypeEnum | None = Field(
+        None,
+        alias='listingType',
+        description='This enum value indicates the listing type for which minimum starting price policies are being returned. Note: The only applicable values for this method are AUCTION and FIXED_PRICE_ITEM .',
+    )
+    min_buy_it_now_price_percent: str | None = Field(
+        None,
+        alias='minBuyItNowPricePercent',
+        description='The minimum percentage value that a Buy It Now price for an auction listing must be above the starting bid price for the same listing. This field is only returned and applicable for auction listings.',
+    )
+    start_price: Amount | None = Field(
+        None,
+        alias='startPrice',
+        description="For auction listings, this field indicates the lowest dollar value that can be set for the item's starting bid. For fixed-price listings, this field indicates the lower dollar value that can be set for the item's sale price.",
+    )
+
+
+class MotorsListingPoliciesResponse(EbayModel):
+    motors_listing_policies: list[MotorsListingPolicy] | None = Field(
+        None,
+        alias='motorsListingPolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class MultiCompatibilityPropertyValuesRequest(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which to retrieve property values. Use the getAutomotivePartsCompatibilityPolicies method to retrieve a list of categories that support parts compatibility.',
+    )
+    property_filters: list[PropertyFilterInner] | None = Field(
+        None,
+        alias='propertyFilters',
+        description='This array can be used to specify the compatibility properties used to limit the result set. Only values associated with the specified name-value pairs will be returned in the response. For example, if the propertyName is set to Year and the propertyValue is set to 2022 , only compatible vehicles from 2022 will be returned. At least one property name-value pair must be used.',
+    )
+    property_names: list[str] | None = Field(
+        None,
+        alias='propertyNames',
+        description="This comma-delimited array specifies the names of the properties for which to retrieve associated property values. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category.",
+    )
+
+
+class MultiCompatibilityPropertyValuesResponse(EbayModel):
+    compatibilities: list[Compatibility] | None = Field(
+        None,
+        description='This container defines the compatibility details associated with the specified property name value(s).',
+    )
+    metadata_version: str | None = Field(
+        None,
+        alias='metadataVersion',
+        description='The version number of the metadata. This version is upticked whenever there are compatibility name changes for the specified marketplace.',
+    )
+
+
+class NegotiatedPricePolicyResponse(EbayModel):
+    negotiated_price_policies: list[NegotiatedPricePolicy] | None = Field(
+        None,
+        alias='negotiatedPricePolicies',
+        description='A list of category IDs and the policies related to negotiated-price items for each of the listed categories.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ProductResponseCompatibilityDetails(EbayModel):
+    note_details: list[PropertyFilterInner] | None = Field(
+        None,
+        alias='noteDetails',
+        description='This array returns additional comments about the corresponding product in the form of name-value pairs.',
+    )
+    product_details: list[PropertyValues] | None = Field(
+        None,
+        alias='productDetails',
+        description='This array returns details about the product in the form of name-value pairs.',
+    )
+
+
+class PropertyNamesResponseProperties(EbayModel):
+    dataset: str | None = Field(
+        None,
+        description='This field defines the types of properties are returned for the specified catalog-enabled category. Valid values: DisplayableProductDetails : Properties for use in a user interface to describe products. DisplayableSearchResults : Properties for use in results for product searches. Searchable : Properties for use in searches. Sortable : Properties that are suitable for sorting.',
+    )
+    property_names: list[PropertyNamesResponsePropertyNames] | None = Field(
+        None,
+        alias='propertyNames',
+        description="This array specifies the names of the properties associated with the specified category in the specified marketplace. For example, typical vehicle property names are 'Make', 'Model', 'Year', 'Engine', and 'Trim', but will vary based on the eBay marketplace and the eBay category.",
+    )
+
+
+class RegulatoryAttribute(EbayModel):
+    name: RegulatoryAttributeEnum | None = Field(
+        None, description='A unique value identifying a specific regulatory attribute.'
+    )
+    usage: GenericUsageEnum | None = Field(
+        None,
+        description='The enumeration value in this field indicates whether the corresponding attribute is recommended or required for the corresponding leaf category.',
+    )
+
+
+class RegulatoryPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the leaf category to which the corresponding policies pertain.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree, which reflects the specified marketplace.',
+    )
+    supported_attributes: list[RegulatoryAttribute] | None = Field(
+        None,
+        alias='supportedAttributes',
+        description='A list of supported regulatory attributes for this marketplace.',
+    )
+
+
+class RegulatoryPolicyResponse(EbayModel):
+    regulatory_policies: list[RegulatoryPolicy] | None = Field(
+        None,
+        alias='regulatoryPolicies',
+        description='A list of eBay policies that define whether or not you must include required regulatory information for leaf categories on the given marketplace.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ShippingPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which metadata is being returned.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='The unique identifier of the category tree.',
+    )
+    global_shipping_enabled: bool | None = Field(
+        None,
+        alias='globalShippingEnabled',
+        description='Indicates if the Global Shipping Program (GSP) is supported for the category. Note: GSP is only supported by the eBay UK marketplace ( EBAY_GB ).',
+    )
+    group1_max_flat_shipping_cost: Amount | None = Field(
+        None,
+        alias='group1MaxFlatShippingCost',
+        description='Returns the applicable max cap per shipping cost for shipping service group1.',
+    )
+    group2_max_flat_shipping_cost: Amount | None = Field(
+        None,
+        alias='group2MaxFlatShippingCost',
+        description='Returns the applicable max cap per shipping cost for shipping service group2.',
+    )
+    group3_max_flat_shipping_cost: Amount | None = Field(
+        None,
+        alias='group3MaxFlatShippingCost',
+        description='Returns the applicable max cap per shipping cost for shipping service group3.',
+    )
+    handling_time_enabled: bool | None = Field(
+        None,
+        alias='handlingTimeEnabled',
+        description="Indicates if a seller's stated handling time is enabled for a category. A handling time is generally needed for items that are shipped to the buyer, but not necessarily applicable to freight shipping or local pickup.",
+    )
+    max_flat_shipping_cost: Amount | None = Field(
+        None,
+        alias='maxFlatShippingCost',
+        description='The maximum cost the seller can charge for the first domestic flat-rate shipping service. Mutually exclusive with the GroupNMaxFlatShippingCost elements.',
+    )
+    shipping_terms_required: bool | None = Field(
+        None,
+        alias='shippingTermsRequired',
+        description='Indicates whether the category requires sellers to specify shipping details at listing time.',
+    )
+
+
+class SiteVisibilityPoliciesResponse(EbayModel):
+    site_visibility_policies: list[SiteVisibilityPolicy] | None = Field(
+        None,
+        alias='siteVisibilityPolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class SortOrderInner(EbayModel):
+    sort_order: SortOrderProperties | None = Field(
+        None,
+        alias='sortOrder',
+        description='This container is used to define the property to be used in the sorting.',
+    )
+    sort_priority: str | None = Field(
+        None,
+        alias='sortPriority',
+        description='The priority of the specified sort order provided. For example, when a property is assigned Sort1 , its values are sorted first. Values for the property assigned Sort2 are sorted second, and so on. Valid values : Sort1 Sort2 Sort3 Sort4 Sort5',
+    )
+
+
+class SpecificationRequest(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay leaf category for which compatibility details are being retrieved. This category must be a valid eBay category on the specified eBay marketplace, and the category must support parts compatibility for cars, trucks, or motorcycles.',
+    )
+    compatibility_property_filters: list[PropertyFilterInner] | None = Field(
+        None,
+        alias='compatibilityPropertyFilters',
+        description='This comma-delimited array can be used to restrict the number of compatible application name-value pairs returned in the response by specifying the properties that the seller wishes to be included in the response. Only compatible applications with the specified properties will be returned. Properties that can be specified here include make, model, year, and trim.',
+    )
+    dataset: str | None = Field(
+        None,
+        description='This field can be used to define the type of properties that will be returned in the response. For example, if you specify Searchable , the compatibility details will contain properties that can be used to search for products, such as make or model. Note: This field cannot be used alongside dataPropertyName . If both are used, an error will occur.',
+    )
+    dataset_property_name: list[str] | None = Field(
+        None,
+        alias='datasetPropertyName',
+        description='This comma-delimited array can be used to define the specific property name(s) that will be returned in the response. For example, if you specify Engine , the result set will only contain engines that are compatible with the input criteria. Note: This array cannot be used alongside dataset . If both are used, an error will occur.',
+    )
+    exact_match: bool | None = Field(
+        None,
+        alias='exactMatch',
+        description='This boolean can be used to specify that the compatibilities returned in the response are to be defined by an exact match on the input value of specification properties. By default, an expanded compatibility match is done when it applies, such as for Load Index, where a compatible vehicle is one that has a load index requirement that is less than or equal to the input.',
+    )
+    pagination_input: PaginationInput | None = Field(
+        None,
+        alias='paginationInput',
+        description='Important! Pagination is not yet supported by this method. If this container is included in the request, it will be ignored.',
+    )
+    sort_orders: list[SortOrderInner] | None = Field(
+        None,
+        alias='sortOrders',
+        description='This array specifies the sorting order of the compatibility properties. Any of the searchable properties can be used to specify search order. Up to 5 levels of sort order may be specified. Note: If no sort order is specified through this field, the default sort order of popularity descending is applied.',
+    )
+    specifications: list[PropertyFilterInner] | None = Field(
+        None,
+        description='This array defines the specifications of the part, in the form of name-value pairs, for which compatible applications will be retrieved.',
+    )
+
+
+class SpecificationResponse(EbayModel):
+    compatibility_details: list[Compatibility] | None = Field(
+        None,
+        alias='compatibilityDetails',
+        description='This container returns the list of all compatible application name-value pairs for the given filter criteria.',
+    )
+    pagination: Pagination | None = Field(
+        None, description='Important! Not currently returned. For future use.'
+    )
+
+
+class TimeDuration(EbayModel):
+    unit: TimeDurationUnitEnum | None = Field(
+        None,
+        description='A time-measurement unit that specifies a singular period of time. A span of time is defined when you apply the value specified in the value field to the value specified for unit . Time-measurement units can be YEAR, MONTH, DAY, and so on. See TimeDurationUnitEnum for a complete list of possible time-measurement units.',
+    )
+    value: int | None = Field(
+        None,
+        description='An integer that represents an amount of time, as measured by the time-measurement unit specified in the unit field.',
+    )
+
+
+class AutomotivePartsCompatibilityPolicyResponse(EbayModel):
+    automotive_parts_compatibility_policies: (
+        list[AutomotivePartsCompatibilityPolicy] | None
+    ) = Field(
+        None,
+        alias='automotivePartsCompatibilityPolicies',
+        description='A list of category IDs and the automotive parts compatibility policies for each of the listed categories.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class CategoryPolicyResponse(EbayModel):
+    category_policies: list[CategoryPolicy] | None = Field(
+        None,
+        alias='categoryPolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ClassifiedAdPolicyResponse(EbayModel):
+    classified_ad_policies: list[ClassifiedAdPolicy] | None = Field(
+        None,
+        alias='classifiedAdPolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class GetMinimumListingPricePoliciesResponse(EbayModel):
+    minimum_listing_price_policies: list[MinimumListingPricePoliciesType] | None = (
+        Field(
+            None,
+            alias='minimumListingPricePolicies',
+            description='This array returns a list of minimum listing price policies for supported types of listings on the specific marketplace',
+        )
+    )
+
+
+class ItemConditionDescriptor(EbayModel):
+    condition_descriptor_constraint: ItemConditionDescriptorConstraint | None = Field(
+        None,
+        alias='conditionDescriptorConstraint',
+        description='This container shows the constraints on a condition descriptor, such as the maximum length, default condition descriptor value ID, cardinality, mode, usage, and applicable descriptor IDs.',
+    )
+    condition_descriptor_help_text: str | None = Field(
+        None,
+        alias='conditionDescriptorHelpText',
+        description='A description of the condition descriptor that directs a user to its condition descriptor values. For example, the help text for Card Condition is Select ungraded condition .',
+    )
+    condition_descriptor_id: str | None = Field(
+        None,
+        alias='conditionDescriptorId',
+        description='The unique identification number of a condition descriptor associated with with a conditionDescriptorName . For example, 40001 is the ID for Card Condition . These IDs are used in the addItem family of calls of the Trading API to provide condition descriptor names for the item.',
+    )
+    condition_descriptor_name: str | None = Field(
+        None,
+        alias='conditionDescriptorName',
+        description='The human-readable label for the condition descriptor associated with the conditionDescriptorID . For example, Card Condition is the condition descriptor name for ID 40001',
+    )
+    condition_descriptor_values: list[ItemConditionDescriptorValue] | None = Field(
+        None,
+        alias='conditionDescriptorValues',
+        description='This array shows the possible values that map to the corresponding conditionDescriptorName values. Constraint information and help text are also shown for each value. For example, The ID 40001 is ID for the condition descriptor card condition . The ID 400012 is the ID for the Very Good card condition value.',
+    )
+
+
+class ListingTypePoliciesResponse(EbayModel):
+    listing_type_policies: list[ListingTypePolicy] | None = Field(
+        None,
+        alias='listingTypePolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ProductRequest(EbayModel):
+    application_property_filters: list[PropertyFilterInner] | None = Field(
+        None,
+        alias='applicationPropertyFilters',
+        description="This array is used to filter the properties of an application, such as a vehicle's make or model, that will be returned in the response. Application property filters are specified as name-value pairs. Only products compatible with these name-value pairs will be returned.",
+    )
+    dataset: list[str] | None = Field(
+        None,
+        description='This array defines the type of properties that are returned for the catalog-enabled category. For example, if you specify Searchable , the compatibility details will contain properties that can be used to search for products, such as make or model. Note: This field cannot be used alongside dataPropertyName . If both are used, an error will occur.',
+    )
+    dataset_property_name: list[str] | None = Field(
+        None,
+        alias='datasetPropertyName',
+        description='This comma-delimted array can be used to define the specific property name(s) that will be returned in the response. For example, if you specify Engine , the result set will only contain engines that are compatible with the input criteria. Note: This array cannot be used alongside dataset . If both are used, an error will occur.',
+    )
+    disabled_product_filter: DisabledProductFilter | None = Field(
+        None,
+        alias='disabledProductFilter',
+        description='This container can be used to specify whether or not to filter out products which are disabled for selling on eBay and/or disabled for product review.',
+    )
+    pagination_input: PaginationInput | None = Field(
+        None,
+        alias='paginationInput',
+        description='This container controls the pagination of the result set.',
+    )
+    product_identifier: ProductIdentifier | None = Field(
+        None,
+        alias='productIdentifier',
+        description='This container is used to provide unique identifier for the product. The product identifier consists of an identifier type and value, and are unique across all sites.',
+    )
+    sort_orders: list[SortOrderInner] | None = Field(
+        None,
+        alias='sortOrders',
+        description='This array controls the sort order of compatibility properties.',
+    )
+
+
+class ProductResponse(EbayModel):
+    compatibility_details: list[ProductResponseCompatibilityDetails] | None = Field(
+        None,
+        alias='compatibilityDetails',
+        description='This container provides compatibility details for the specified product.',
+    )
+    pagination: Pagination | None = Field(
+        None,
+        description='This container returns the pagination settings for the result set.',
+    )
+
+
+class PropertyNamesResponse(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The unique identifier of the eBay category specified in the request.',
+    )
+    properties: list[PropertyNamesResponseProperties] | None = Field(
+        None,
+        description='This array contains all of the properties for the specified category.',
+    )
+
+
+class ReturnPolicyDetails(EbayModel):
+    policy_description_enabled: bool | None = Field(
+        None,
+        alias='policyDescriptionEnabled',
+        description="If set to true , this flag indicates you can supply a detailed return policy description within your return policy (for example, by populating the returnInstructions field in the Account API's createReturnPolicy ). User-supplied return policy details are allowed only in the DE, ES, FR, and IT marketplaces.",
+    )
+    refund_methods: list[RefundMethodEnum] | None = Field(
+        None,
+        alias='refundMethods',
+        description='A list of refund methods allowed for the associated category. Note: Depending on the API used to setup your return policy, available refund methods are defined differently.',
+    )
+    return_methods: list[ReturnMethodEnum] | None = Field(
+        None,
+        alias='returnMethods',
+        description='A list of return methods allowed for the associated category. Note: Depending on the API used to setup your return policy, available return methods are defined differently.',
+    )
+    return_periods: list[TimeDuration] | None = Field(
+        None,
+        alias='returnPeriods',
+        description='A list of return periods allowed for the associated category. Note: Depending on the API used to setup your return policy, return periods are defined differently. Account v1 API When using createReturnPolicy and updateReturnPolicy to create/manage business policies, use the returnPeriod and internationalOverride.returnPeriod containers to set the return period(s) for the business policy.',
+    )
+    returns_acceptance_enabled: bool | None = Field(
+        None,
+        alias='returnsAcceptanceEnabled',
+        description='A value of true in this field indicates that return policies are applicable to the corresponding leaf category.',
+    )
+    return_shipping_cost_payers: list[ReturnShippingCostPayerEnum] | None = Field(
+        None,
+        alias='returnShippingCostPayers',
+        description='A list of allowed values for who pays for the return shipping cost. Note that for SNAD returns, the seller is always responsible for the return shipping cost. Note: Depending on the API used to setup your return policy, specifiying that the buyer or seller is responsible for paying for return shipping costs is defined differently.',
+    )
+
+
+class ShippingPoliciesResponse(EbayModel):
+    shipping_policies: list[ShippingPolicy] | None = Field(
+        None,
+        alias='shippingPolicies',
+        description='This array contains applicable policy metadata for the leaf categories returned for the marketplace specified in the path parameter marketplace_id and optionally limited by only those leaf category IDs specified in the query parameter filter .',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='An array of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ItemCondition(EbayModel):
+    condition_description: str | None = Field(
+        None,
+        alias='conditionDescription',
+        description='The human-readable label for the condition (e.g., "New"). This value is typically localized for each site. Note that the display name can vary by category. For example, the description for condition ID 1000 could be called "New: with Tags" in one category and "Brand New" in another. For details on condition IDs and descriptions, see Item condition ID and name values .',
+    )
+    condition_descriptors: list[ItemConditionDescriptor] | None = Field(
+        None,
+        alias='conditionDescriptors',
+        description='This array contains the possible condition descriptors and condition descriptor values applicable for the specified category. It also returns usage requirements, maximum length, cardinality, and help text. Note: This array is only returned for categories that support condition descriptors.',
+    )
+    condition_help_text: str | None = Field(
+        None,
+        alias='conditionHelpText',
+        description='A detailed description of the condition denoted by the conditionID and conditionDescription .',
+    )
+    condition_id: str | None = Field(
+        None,
+        alias='conditionId',
+        description='The ID value of the selected item condition. For information on the supported condition ID values, see Item condition ID and name values .',
+    )
+    usage: UsageEnum | None = Field(
+        None,
+        description="The value returned in this field indicates if there are any usage restrictions or requirements for the corresponding item condition in the corresponding category. Note: Currently, the only supported value is 'RESTRICTED', and this field will only be returned for the following conditions: 2000, 2010, 2020, 2030. Sellers must be pre-approved to use any of these item conditions.",
+    )
+
+
+class ItemConditionPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The category ID to which the item-condition policy applies.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='A value that indicates the root node of the category tree used for the response set. Each marketplace is based on a category tree whose root node is indicated by this unique category ID value. All category policy information returned by this call pertains to the categories included below this root node of the tree.',
+    )
+    item_condition_required: bool | None = Field(
+        None,
+        alias='itemConditionRequired',
+        description='This flag denotes whether or not you must list the item condition in a listing for the specified category. If set to true , you must specify an item condition for the associated category.',
+    )
+    item_conditions: list[ItemCondition] | None = Field(
+        None,
+        alias='itemConditions',
+        description="The item-condition values allowed in the category. Note: The ‘Seller Refurbished’ item condition (condition ID 2500) has been replaced by the 'Excellent - Refurbished', 'Very Good - Refurbished', and 'Good - Refurbished' item conditions in a select number of eBay marketplaces and categories.",
+    )
+
+
+class ItemConditionPolicyResponse(EbayModel):
+    item_condition_policies: list[ItemConditionPolicy] | None = Field(
+        None,
+        alias='itemConditionPolicies',
+        description="A list of category IDs and the policies for how to indicate an item's condition in each of the listed categories.",
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )
+
+
+class ReturnPolicy(EbayModel):
+    category_id: str | None = Field(
+        None,
+        alias='categoryId',
+        description='The category ID to which the return policies apply.',
+    )
+    category_tree_id: str | None = Field(
+        None,
+        alias='categoryTreeId',
+        description='A value that indicates the root node of the category tree used for the response set. Each marketplace is based on a category tree whose root node is indicated by this unique category ID value. All category policy information returned by this call pertains to the categories included below this root node of the tree.',
+    )
+    domestic: ReturnPolicyDetails | None = Field(
+        None,
+        description='This complex type defines the category policies related to domestic item returns.',
+    )
+    international: ReturnPolicyDetails | None = Field(
+        None,
+        description='This complex type defines the category policies related to international item returns.',
+    )
+    required: bool | None = Field(
+        None,
+        description='If set to true , this flag indicates that you must specify a return policy for items listed in the associated category. Note that not accepting returns (setting returnsAcceptedEnabled to false ) is a valid return policy.',
+    )
+
+
+class ReturnPolicyResponse(EbayModel):
+    return_policies: list[ReturnPolicy] | None = Field(
+        None,
+        alias='returnPolicies',
+        description='A list of elements, where each contains a category ID and a flag that indicates whether or not listings in that category require a return policy.',
+    )
+    warnings: list[ErrorDetailV3] | None = Field(
+        None,
+        description='A list of the warnings that were generated as a result of the request. This field is not returned if no warnings were generated by the request.',
+    )