# /artnet/galleries/artworks

`POST /api/artnet/galleries/artworks`

Price: 20 credits

List the artworks a gallery offers on Artnet, with the same filters and sort orders as artwork search. Returns artworks with artist, medium, dimensions, price and sale status.

## How to use it

A gallery's inventory on Artnet. Gallery ids come from artnet/artists/dealers or from the institution of an artwork returned by artnet/artworks/search.

## Parameters

- `access-token` (string, required)

## Request body

- `timeout` (integer) — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
- `keyword` (string, nullable) — Search text (examples: "skull"; minLength: 1)
- `object_types` (array) — Object types (default: []; one of: "advertising_collectibles", "altars", "amulets", "ancient_egyptian_art", "antiquities", "architectural_and_garden_elements", "architectural_properties", "armchairs_club_chairs", "armoires", "arms_armor_militaria", "automobilia", "awards", "basins_fountains", "baskets", "beadwork", "beds", "beds_and_daybeds", "benches", "bookcases", "books", "books_and_ephemera", "books_maps_manuscripts", "bottles_jars_flasks", "bowls", "boxes", "bracelets", "brooches_pins", "busts", "cabinets", "candlesticks_candelabras", "cartel_wall", "case_piece", "ceiling_lights", "cellarettes", "centerpieces", "ceramics", "chaises_lounges", "chandeliers", "chests_of_drawers_commodes", "chests_trunks", "clocks_and_watches", "coffee_low", "coins_stamps_seals", "collectibles", "columns", "comics_and_animations", "condiments_table_accessories", "consoles_pier_tables", "cooking_tools", "corner_cupboards", "costume_clothing_fashion", "cribs", "daybeds", "decorative_objects", "decorative_pictures", "demi_lune", "design", "desk_and_writing_accessories", "desks_work_tables", "devotional_jewelry", "dining_center", "dining_side_chairs", "dining_suites", "dolls", "doors_gates_balustrades", "dressing_tables_vanities", "drinking_vessels", "dry_bars", "dumbwaiters", "earrings", "electronics_machines", "embroideries_samplers", "estates", "figures_figurines", "figures_figurines_sculpture_carvings", "figures_statuettes", "film_video", "fireplace_accessories", "flatware", "floor_lamps_torchieres", "folding_extension_tables", "frame", "fretted_string", "funerary_objects", "game_card", "games_toys_models", "garden_furniture", "gentlemens_jewelry", "glass", "glass_paintings", "guitar", "hair_jewelry_crowns_headgear", "icons_devotional_pictures", "incense_burners", "installation", "jewelry", "judaica", "lace_silk", "lamp_shades", "lanterns", "letters_and_manuscripts", "lighting", "locks", "loose_stones", "mantel_table", "maps", "masks", "medical", "miniatures", "mirror", "movie_and_music_memorabilia", "musical_instruments", "necklaces_pendants", "nesting_stacking", "new_media", "objects_of_vertu", "occasional", "oil_lamps", "orders_and_decorations", "other_furnishings", "ottomans_poufs", "paintings", "parures", "pendulum_longcase", "percussion", "performance", "petroliana", "photographs", "piano_keyboard", "pictures_wallpapers_mirrors_frames", "pillows", "pitchers_jugs_ewers", "planters_jardinieres", "posters", "prints_and_multiples", "quilts_blankets", "relics", "reliefs_plaques", "religious_and_ceremonial_objects", "rings", "rocks_fossils_and_minerals", "rugs_and_carpets", "rugs_carpets_textiles", "salon_suites", "science_and_technology", "scientific_instruments_and_objects_of_curiosity", "sconces", "screens", "sculpture", "seating", "secretaries", "serving_dishes_plates_wares", "sideboards", "silver", "site_specific", "sofas_settees", "sports_equipment", "stands_racks", "stools_taborets", "table_lamps", "tables", "tableware_flatware_serveware", "tapestries", "taxidermy", "tea_coffee_chocolate_wares", "tiles_mosaics", "tobacco_items", "tools", "vanity_and_travel_accessories", "vases_urns_amphoras", "wallpaper", "washroom_items", "watches", "wind", "window_dressings_and_canopies", "windows_stained_glass", "works_on_paper"; examples: ["paintings"])
- `classifications` (array) — Classifications (default: []; one of: "curated_collection_emerging_photographers", "curated_collection_fashion_photography", "curated_collection_japanese_contemporary", "curated_collection_spotlight_on_art_brut", "decorative_art_and_antiques", "fine_art")
- `categories` (array) — Collecting categories (default: []; one of: "19th_century_european_and_british_art", "19th_century_european_art", "20th_and_21st_century_design", "aboriginal_and_australian_art", "african_american_art", "african_art", "african_decorative_art", "african_oceanic_and_pre_columbian_works_of_art", "american_art", "american_decorative_art_from_colonial_to_1900", "american_furniture_and_decorative_art", "american_indian_and_inuit_works_of_art", "antiquities", "arms_and_armor", "art_nouveau_and_art_deco", "artists_books_rare_books_and_manuscripts", "asian_art", "asian_decorative_art", "bauhaus", "books_and_manuscripts", "british_art", "british_furniture_and_decorative_art", "canadian_art", "ceramics_and_glass", "chinese_art", "chinese_works_of_art", "classical_and_near_eastern_antiquities", "contemporary_art", "contemporary_asian_art", "contemporary_middle_eastern_art", "contemporary_realism", "decorative_art", "design", "drawings_and_works_on_paper", "emerging_artists", "emerging_photography", "european_and_british_decorative_art_18th_century", "european_and_british_decorative_art_19th_century", "european_and_british_decorative_art_to_1700", "european_furniture_and_decorative_art", "european_sculpture_and_works_of_art", "european_silver_and_vertu", "fashion_photography", "fine_art", "folk_and_naive_art", "folk_naive_and_outsider_art", "frames_and_mirrors", "furniture", "german_and_austrian_and_swiss_art", "glass_and_ceramics", "greek_art", "hudson_river_school_and_early_american_art", "impressionist_and_modern_art", "indian_and_south_asian_art", "indian_and_south_asian_works_of_art", "irish_and_scottish_art", "islamic_works_of_art", "italian_art", "japanese_and_korean_works_of_art", "japanese_art", "japanese_contemporary", "jewelry", "jewelry_and_gemstones", "korean_art", "latin_american_art", "lighting", "marine_paintings_and_nautical_works_of_art", "middle_eastern_art", "ming_dynasty_1368_1644", "modern_1891_present", "modern_1901_present", "modern_1912_present", "neolithic_to_sui_dynasty_618", "oceanic_decorative_art", "old_master_drawings", "old_master_paintings", "old_masters", "other_furniture_and_decorative_art", "photographs", "photography", "pop_art", "pre_columbian_and_native_american_decorative_art", "prints", "prints_and_multiples", "qing_dynasty_1644_1911", "queen_anne_1703_1727", "queen_anne_1731_1760", "rugs_carpets_and_textiles", "russian_art", "russian_silver_and_vertu", "russian_works_of_art", "scandinavian_art", "sculpture", "silver", "silver_and_objects_of_vertu", "southwest_art", "spanish_art", "sporting_art", "spotlight_on_art_brut", "surrealism", "tang_dynasty_to_yuan_dynasty_618_1368", "urban_art", "victorian_1838_1901", "victorian_and_edwardian_art", "watches", "william_and_mary_1690_1702", "william_and_mary_1690_1730"; examples: ["contemporary_art"])
- `movements` (array) — Art movements (default: []; one of: "20th_century_and_contemporary_chinese_art", "85_new_wave", "aboriginal_art", "abstract_art", "abstract_expressionism", "academic_art", "action_painting", "aesthetic_movement", "african_american_art", "african_art", "african_oceanic_and_pre_columbian_works_of_art", "american_regionalism", "american_scene_painting", "american_social_realism", "anglo_indian_colonial", "appropriation", "art_deco", "art_nouveau", "art_of_the_21st_century", "arte_povera", "arts_and_crafts", "ashcan_school", "assemblage", "asuka", "barbizon_school", "baroque_art", "bauhaus", "bay_area_figurative_art", "belle_epoque", "biedermeier", "black_arts_movement", "black_mountain_college", "body_art", "brutalism", "byzantine_art", "chang_an_school", "chenghua_period", "chicago_school_of_design", "chinese_art", "chinese_contemporary_ink", "chinese_export", "chinese_painting_and_calligraphy", "chippendale", "chongzhen_period", "cizhou_ware", "co_br_a", "colonial_period", "color_field", "conceptual_art", "concrete_art", "constructivism", "contemporary_african_art", "contemporary_art", "contemporary_chinese_art", "contemporary_design", "contemporary_indian_art", "contemporary_japanese_art", "contemporary_japanese_design", "contemporary_korean_art", "contemporary_korean_design", "contemporary_latin_american_art", "contemporary_middle_eastern_art", "contemporary_oceanic", "contemporary_realism", "contemporary_russian_art", "contemporary_south_asian_art", "cubism", "cynical_realism", "dada", "dali_kingdom_9371253", "daoguang_period", "dawenkou_culture", "de_stijl", "dehua_ware", "der_blauer_reiter", "deutscher_werkbund", "die_brucke", "ding_ware", "directoire", "dusseldorf_school_of_photography", "early_nara", "early_renaissance", "east_village_art", "eastern_han", "eastern_zhou", "edo_period", "edwardian", "elizabethan", "emerging_art", "empire", "expressionism", "farm_security_administration", "fauvism", "federal", "feminist_art", "five_dynasties", "fluxus", "four_monks_school", "four_wangs_school", "funk_art", "futurism", "gaudy_art", "ge_ware", "geometric_abstraction", "georgian", "german_expressionism", "glasgow_style", "goryeo", "gothic_art", "grand_manner", "group_f_64", "guan_ware", "guangxu_period", "gutai", "hague_school", "han_dynasty", "happenings", "hard_edge_painting", "harlem_renaissance", "heian", "high_renaissance", "hongshan_culture", "hongwu_period", "hongwujianwen_period", "hongxi_period", "hongzhi_period", "hudson_river_school", "hutian_ware", "hyperrealism", "impressionism", "indian_and_southeast_asian_works_of_art", "indian_art", "indus_civilization", "islamic_art", "jacobean", "japanese_art", "japanese_contemporary_decorative_art", "japanese_rule", "japanese_superflat", "japonisme", "jiajing_period", "jian_ware", "jiaqing_period", "jin_dynasty", "jingdezhen_ware", "jingjin_school", "jingtai_period", "jinling_school", "jizhou_ware", "joseon_dynasty", "jun_ware", "kamakura", "kangxi_period", "kinetic_art", "kofun", "korean_art", "land_art", "latin_american_art", "les_nabis", "liangzhu_culture", "liao_dynasty", "light_and_space", "lingnan_school", "longqing_period", "longquan_ware", "longshan_culture", "louis_philippe", "louis_xiii", "louis_xiv", "louis_xv", "louis_xvi", "lyrical_abstraction", "magic_realism", "mamluks", "mannerism", "medieval_art", "medieval_period", "meiji_period", "mexican_muralism", "mid_century_modernism", "middle_eastern_art", "middle_jomon", "ming_dynasty", "minimalism", "modern_art", "modern_middle_eastern_art", "momoyama_period", "mono_ha", "mughal_empire", "mughals", "muromachi_period", "napoleon_iii", "nara", "nasrids", "native_american_art", "native_realism", "nazarene", "neo_conceptualism", "neo_expressionism", "neo_geo", "neo_pop", "neoclassicism", "neolithic", "neolithic_period", "neolithic_to_sui_dynasty", "new_generation_art", "new_jinling_school", "new_leipzig_school", "new_media_art", "new_objectivity", "new_topographics", "new_york_school", "northern_renaissance", "northern_school", "northern_song", "nouveau_realisme", "oceanic_art", "old_masters", "op_art", "orientalism", "orphism", "ottomans", "outsider_art", "pattern_and_decoration_movement", "performance_art", "period_of_northern_and_southern_dynasties", "photo_league", "photo_secession", "photorealism", "pictures_generation", "pilgrim", "pointillism", "political_pop", "pont_aven_school", "pop_art", "post_70s_ego_generation", "post_impressionism", "post_minimalism", "post_painterly_abstraction", "post_war", "postmodernism", "pre_columbian_art", "pre_raphaelism", "qianlong_period", "qin_dynasty", "qing_dynasty", "quanzhou_ware", "queen_anne", "rajput_paintings", "rayonism", "realism", "regence", "regency", "renaissance", "republic_period_early_20th_century", "restauration", "revival_periods", "rococo", "romanesque", "romanticism", "ru_ware", "russian_art", "safavids", "section_d_or", "shaker", "shang_dynasty", "shanghai_school", "sheraton", "shiwan_ware", "shunzhi_period", "six_dynasties", "six_dynastiessui_dynasty", "socialist_realism", "song_dynasty", "southeast_asian_art", "southern_school", "southern_song", "spatialism", "spiral_group", "spring_and_autumn_period", "stars_art_group", "sui_dynasty", "suprematism", "surrealism", "symbolism", "synchromism", "synthetic_cubism", "tachisme", "taichang_period", "taisho_showa_period", "tang_dynasty", "tang_dynasty_to_yuan_dynasty", "tang_dynastyfive_dynasties", "the_golden_age_of_illustration", "the_group_of_seven", "three_kingdom_period", "three_kingdoms", "tianqi_period", "tianshun_period", "timurids", "tonalism", "tongzhi_period", "transavanguardia", "transitional", "tudor", "ukiyo_e", "unified_silla_kingdom", "urban_art", "vancouver_school", "victorian", "vienna_secession", "wanli_period", "wanlitaichang_period", "warring_states_period", "west_coast_art", "western_han", "western_xia_10381227", "western_zhou", "william_and_mary", "william_iv", "windsor", "wumen_school_wu_school", "xia_dynasty", "xianfeng_period", "xin_dynasty_923_ce", "xin_ware", "xuande_period", "xuantong_period", "yangshao_culture", "yangzhou_school", "yaozhou_ware", "yayoi", "yixing_ware", "yongle_period", "yonglehongxi_period", "yongzheng_period", "young_british_artists", "yuan_dynasty", "yue_ware", "zero", "zhejiang_school_zhe_school", "zhengde_period", "zhengtong_period", "zhengtongtianshun_period", "zhou_dynasty"; examples: ["pop_art"])
- `materials` (array) — Materials (default: []; one of: "acetate", "acrylic", "agate", "albumen_print", "alkyd", "aluminum", "animation_video", "anodized_aluminum", "aquatint", "archival_inkjet_print", "archival_pigment_print", "artists_book", "ash", "audio", "autochrome", "bamboo", "beech", "birch", "blood", "blown_glass", "bmp", "bone_china", "brass", "brick", "bronze", "calotype", "candle_soot", "cane", "carbon_print", "carborundum", "cedar", "ceramic", "ceramic_edition", "ceramics_and_glass", "chalk", "charcoal", "chine_applique", "chine_colle", "chrome", "chrome_plated", "chromogenic_print_c_print", "cibachrome", "clay", "collage", "collodion_negative", "collotype", "color_coupler_print", "colored_pencil", "conte_crayon", "copper", "coral", "cotton", "crayon", "crystal", "cyanotype", "daguerreotype", "diamond", "digital_chromogenic_print", "digital_inkjet_print", "digital_media", "digital_pigment_print", "digital_print", "drypoint", "dye_destruction_print", "dye_transfer_print", "earth_dirt", "earthenware", "ebony", "ektacolor_print", "embossing", "embroidery", "emerald", "enamel", "encaustic", "engraving", "etching", "fabric", "faience", "favrile_glass", "feather", "fiberglass", "film", "film_and_video", "fluorescent_light", "food_as_medium", "found_object", "fresco", "fruitwood", "fur", "gelatin_silver_print", "generative_software_ai", "giclee", "gif", "gilt", "glass", "glazed_ceramic", "glazed_terracotta", "gold", "gold_leaf", "gold_plated", "gold_vermeil", "gouache", "granite", "graphite", "household_gloss", "html", "impasto", "incense_ash", "ink", "ink_wash_sumi_e", "inkjet_print", "intaglio", "iron", "ivory", "jade", "japanese_print", "javascript", "jpg_jpeg", "lacquer", "lambda_print", "leather", "led_light", "lighting", "limestone", "linen", "linocut", "lithograph", "loose_stones", "mahogany", "majolica", "maple", "marble", "marker", "matchsticks", "metal", "metalpoint", "mezzotint", "mirror", "mixed_media", "mixografia", "mobile", "monoprint", "monotype", "montage", "mother_of_pearl", "mp3", "mp4", "natural_material", "neon_light", "nft", "nickel", "nickel_plated", "oak", "offset_lithograph", "oil", "oil_stick", "paint_marker", "paper", "pastel", "pearl", "pen", "photogenic_drawing", "photogram", "photogravure", "photolithograph", "pigment_print", "plaster", "plastic", "platinum", "platinum_palladium_print", "platinum_print", "plexiglas", "plywood", "png", "polaroid", "polyester", "polyurethane", "porcelain", "porcelain_edition", "precious_stones", "pressed_paper_pulp", "raku", "relief", "resin", "rosewood", "ruby", "salt_print", "sand", "sapphire", "satin", "scrap_metal", "screenprint", "scrolls", "semi_precious_stones", "sheet_metal", "silicon", "silk", "silkscreen", "silver", "silver_plated", "silver_print", "spray_enamel", "spray_paint", "stained_glass", "stainless_steel", "steel", "stencil", "sterling_silver", "stone", "suede", "svg", "synthetic_material", "teak", "tempera", "terracotta", "tiff", "tin", "tri_toned_offset_lithograph", "turquoise", "ukiyo_e", "upholstery", "vacuum_formed_plastic", "velvet", "video", "video_edition", "virtual_reality", "wallpaper", "walnut", "watercolor", "wax", "web_p", "wood", "woodburytype", "woodcut", "wool", "zip"; examples: ["oil"])
- `media` (array) — Exact medium texts (default: []; examples: ["oil on canvas"])
- `periods` (array) — Periods (default: []; one of: "10th_century", "10th_century_bc", "11th_century", "11th_century_bc", "12th_century", "12th_century_bc", "13th_century", "13th_century_bc", "14th_century", "14th_century_bc", "15th_century", "15th_century_bc", "16th_century", "16th_century_bc", "17th_century", "17th_century_bc", "18th_century", "18th_century_bc", "1900s", "1910s", "1920s", "1930s", "1940s", "1950s", "1960s", "1970s", "1980s", "1990s", "19th_century", "19th_century_bc", "1st_century", "1st_century_bc", "20th_century", "20th_century_bc", "21st_century", "2nd_century", "2nd_century_bc", "3rd_century", "3rd_century_bc", "4th_century", "4th_century_bc", "5th_century", "5th_century_bc", "6th_century", "6th_century_bc", "7th_century", "7th_century_bc", "8th_century", "8th_century_bc", "9th_century", "9th_century_bc", "classical_chinese", "contemporary_chinese", "modern_chinese", "pre_20th_century_bc"; examples: ["20th_century"])
- `regions` (array) — Regions of origin (default: []; one of: "afghanistan", "africa", "albania", "algeria", "anatolia", "angola", "antigua_and_barbuda", "argentina", "armenia", "asia", "australia", "austria", "azerbaijan", "bahrain", "bangladesh", "belarus", "belgium", "benin", "bhutan", "bolivia", "borneo", "bosnia", "botswana", "brazil", "british_isles", "brunei", "bulgaria", "burkina_faso", "burma", "cambodia", "cameroon", "canada", "caribbean", "central_african_republic", "central_america_and_the_caribbean", "central_asia", "chad", "chile", "china", "colombia", "costa_rica", "croatia", "cuba", "cyprus", "czech_republic", "democratic_republic_of_the_congo", "denmark", "dominican_republic", "east_asia", "easter_island", "ecuador", "egypt", "el_salvador", "england", "eritrea", "estonia", "ethiopia", "eurasia", "europe", "fiji", "finland", "flemish", "france", "french_guiana", "gabon", "gambia", "georgia", "germany", "ghana", "greece", "greenland", "guadeloupe", "guatemala", "guinea", "guinea_bissau", "guyana", "haiti", "honduras", "hungary", "iceland", "india", "indonesia", "iran", "iraq", "ireland", "israel", "italy", "ivory_coast", "jamaica", "japan", "jordan", "kazakhstan", "kenya", "korea", "kosovo", "kuwait", "kyrgyzstan", "laos", "latvia", "lebanon", "lesotho", "liberia", "libya", "liechtenstein", "lithuania", "luxembourg", "madagascar", "malawi", "malaysia", "mali", "malta", "mauritius", "melanesia", "mexico", "middle_east", "moldova", "mongolia", "morocco", "mozambique", "namibia", "nepal", "new_caledonia", "new_guinea", "new_zealand", "nicaragua", "niger", "nigeria", "north_america", "norway", "oceania", "oman", "pakistan", "palestine", "panama", "paraguay", "peru", "philippines", "poland", "polynesia", "portugal", "puerto_rico", "qatar", "republic_of_congo", "republic_of_macedonia", "republic_of_palau", "republic_of_suriname", "republic_of_zaire", "romania", "russia", "rwanda", "samoa", "saudi_arabia", "scotland", "senegal", "serbia", "sierra_leone", "singapore", "slovakia", "slovenia", "solomon_islands", "south_africa", "south_america", "south_asia", "southeast_asia", "soviet_union", "spain", "sri_lanka", "sudan", "sulawesi", "sumatra", "swaziland", "sweden", "switzerland", "syria", "tahiti", "taiwan", "tajikistan", "tanzania", "thailand", "the_bahamas", "the_netherlands", "tibet", "timor", "togo", "trinidad", "tunisia", "turkey", "turkmenistan", "uganda", "ukraine", "united_arab_emirates", "united_states", "uruguay", "uzbekistan", "venezuela", "vietnam", "wales", "yemen", "yugoslavia", "zambia", "zimbabwe"; examples: ["france"])
- `subjects` (array) — Subjects (default: []; one of: "abstract", "adolescent_child", "advertising", "aerial", "afternoon", "allegory", "altar", "americana", "ancient_antiquity", "ancient_egypt", "ancient_rome", "angels", "angular", "animal", "anthropomorphism", "appropriation", "architecture", "art_in_art", "art_technique", "atmospheric", "automatism", "aviation", "baseball", "basketball", "bathers_bathing", "beach", "bedroom", "beijing", "berlin", "bird", "black_and_white_photography", "blues", "boat", "botanical_flora_floral_flowers_plants", "boxing", "brand", "bride", "buddha", "bust_torso", "calligraphy", "car", "caricature", "cartography", "cat", "celebration", "celebrity", "celestial", "chiaroscuro", "chinoiserie", "christian", "christianity", "church", "cinema_film", "circus_carnival", "cityscape", "close_up", "clown", "comic_animation_cartoon", "commercial_building", "construction", "costume", "cottage", "cowboy", "crime", "crucifixion", "curvilinear_form", "cycling", "dance", "death", "death_and_conflict", "desert", "documentary_photography_photojournalism", "dog", "dream", "drip_splatter", "earth", "earthquake", "embrace", "equestrian", "erotica", "evening", "events", "everyday_life", "everyday_objects", "fall", "family", "family_portrait", "fashion", "feet_legs", "fertility_pregnancy_birth_maternity", "figurative", "figure", "film_still", "fire", "fish", "food", "football", "gender", "generative_art", "genre_scene", "geography", "geometric_abstraction_shape_and_pattern", "geometric_shape", "glamour", "golf", "grid", "grotesque", "group_portrait", "hand_arm", "head_face", "highbrow_lowbrow", "hills", "hinduism", "hip_hop", "historical_event", "hockey", "holiday", "home", "hong_kong", "horse", "house", "human_body", "humor_irony_satire", "hunting", "icons", "identity_politics", "ideogram", "imaginary_creature", "individual_portrait", "industrial", "insect", "instrument", "interior", "internal_organ", "invitation", "islam", "islamic", "jazz", "jesus_christ", "judaica", "judaism", "kiss", "kitchen", "kitsch", "labor_and_industry", "labor_laborer", "lakes", "landscape", "lgbtq", "linear_form", "linear_perspective", "living_room", "logo", "london", "los_angeles", "love_and_sexuality", "machine", "madonna_and_child", "map", "marine_maritime_nautical", "metaphysical", "metaphysical_and_surreal", "military_war_conflict", "money", "monochrome", "morning", "mosque", "mother_and_child", "mountain", "music", "myth_and_fantasy", "mythological", "native_american", "natural_disaster", "naturalism", "nature", "new_york", "night", "nude", "number", "occult", "ocean", "optical", "outer_space", "panorama", "paris", "pastoral", "patriotic", "pattern", "photography_and_film", "pixelated", "point_of_view_and_perspective", "political", "politicians_government_leader", "politics_and_propaganda", "pond", "pool", "popular_culture", "portrait_portraiture", "promotion", "propaganda", "psychedelic", "punk", "racial_and_ethnic_identity", "rain", "reflection", "religion", "repetition", "reptile", "rio_de_janeiro", "river", "rock_and_roll", "romance", "rome", "royalty_aristocracy", "rural_life", "saints", "science", "science_and_technology", "seascape", "season", "self_portrait", "sex", "sexuality", "sfumato", "shanghai", "shape_and_pattern", "ship", "shore_scene", "skyscraper", "snow", "soccer", "sport", "spring", "still_life", "street_scene", "stripe", "sublime", "suburbia", "summer", "surreal", "swimming", "symbol", "symmetry", "synagogue", "technology", "temple", "tennis", "text_font", "the_fantastic", "the_gaze", "time", "tokyo", "tornado", "toronto", "tourist", "track_and_field", "train", "transparent_translucent", "transportation", "travel", "travel_tourism_tourist", "trees_forest", "trompe_l_il", "tsunami", "urban", "urbanization", "utopia", "vanitas", "venice", "village_scene", "vintage", "vintage_photography", "violence", "volcanic_eruption", "voyeur_voyeurism", "water", "waterfall", "weapon", "weather", "wedding", "western", "wildfire", "wind", "winter", "wunderkammer"; examples: ["abstract"])
- `artist_nationalities` (array) — Artist nationalities (default: []; one of: "acoma", "afghani", "albanian", "albanian_german", "algerian", "algerian_french", "american", "american_argentine", "american_armenian", "american_australian", "american_austrian", "american_belgian", "american_brazilian", "american_british", "american_cambodian", "american_canadian", "american_chilean", "american_chinese", "american_colombian", "american_croatian", "american_cuban", "american_czech", "american_danish", "american_dominican", "american_dutch", "american_ecuadorian", "american_ethiopian", "american_filipino", "american_french", "american_german", "american_greek", "american_guyanese", "american_haitian", "american_hungarian", "american_indian", "american_iranian", "american_iraqi", "american_irish", "american_israeli", "american_italian", "american_jamaican", "american_japanese", "american_korean", "american_latvian", "american_lithuanian", "american_mexican", "american_new_zealand", "american_nicaraguan", "american_nigerian", "american_norwegian", "american_peruvian", "american_polish", "american_portuguese", "american_romanian", "american_russian", "american_salvadoran", "american_scottish", "american_slovak", "american_slovenian", "american_spanish", "american_sri_lankan", "american_swedish", "american_swiss", "american_taiwanese", "american_thai", "american_trinidadian", "american_turkish", "american_ukrainian", "american_uruguayan", "american_venezuelan", "american_vietnamese", "american_yugoslavian", "angolan", "antiguan", "apache", "argentine", "argentine_austrian", "argentine_chilean", "argentine_french", "argentine_german", "argentine_italian", "argentine_new_zealand", "argentine_spanish", "argentine_swiss", "armenian", "armenian_canadian", "armenian_french", "australian", "australian_british", "australian_chinese", "australian_cypriot", "australian_dutch", "australian_french", "australian_german", "australian_irish", "australian_italian", "australian_japanese", "australian_malaysian", "australian_mongolian", "australian_new_zealand", "australian_russian", "australian_scottish", "australian_taiwanese", "austrian", "austrian_british", "austrian_chinese", "austrian_czech", "austrian_french", "austrian_german", "austrian_hungarian", "austrian_iranian", "austrian_israeli", "austrian_italian", "austrian_mexican", "austrian_polish", "austrian_romanian", "austrian_russian", "austrian_swedish", "austrian_swiss", "austrian_turkish", "austrian_ukrainian", "austrian_yugoslavian", "azerbaijani_russian", "azerbaijanian", "bahamian", "bahraini", "balinese", "bangladeshi", "bangladeshi_irish", "barbadian", "belarusian", "belarusian_french", "belgian", "belgian_canadian", "belgian_chinese", "belgian_czech", "belgian_danish", "belgian_french", "belgian_german", "belgian_italian", "belgian_japanese", "belgian_korean", "belgian_polish", "belgian_romanian", "bengali", "beninese", "beninese_french", "bermudian", "bhutanese", "bohemian", "bolivian", "bosnian", "botswanan", "brazilian", "brazilian_bulgarian", "brazilian_chinese", "brazilian_french", "brazilian_german", "brazilian_italian", "brazilian_japanese", "brazilian_mexican", "brazilian_swiss", "british", "british_canadian", "british_chinese", "british_cypriot", "british_danish", "british_dutch", "british_egyptian", "british_french", "british_german", "british_ghanian", "british_hungarian", "british_indian", "british_irish", "british_israeli", "british_italian", "british_japanese", "british_kenyan", "british_korean", "british_mexican", "british_new_zealand", "british_nigerian", "british_pakistani", "british_palestinian", "british_polish", "british_portuguese", "british_russian", "british_south_african", "british_spanish", "british_swiss", "british_trinidadian", "bruneian", "bulgarian", "bulgarian_israeli", "bulgarian_italian", "burkinabe", "burmese", "cambodian", "cameroonian", "cameroonian_french", "canadian", "canadian_chinese", "canadian_french", "canadian_german", "canadian_haitian", "canadian_honduran", "canadian_hungarian", "canadian_iranian", "canadian_irish", "canadian_israeli", "canadian_korean", "canadian_pakistani", "canadian_polish", "canadian_romanian", "canadian_russian", "canadian_scottish", "canadian_spanish", "canadian_swedish", "canadian_swiss", "canadian_turkish", "canadian_ukrainian", "caribbean", "central_african_republic", "chadian", "cherokee", "cheyenne", "chilean", "chilean_german", "chinese", "chinese_dutch", "chinese_filipino", "chinese_french", "chinese_indian", "chinese_indonesian", "chinese_japanese", "chinese_korean", "chinese_malaysian", "chinese_new_zealand", "chinese_russian", "chinese_singaporean", "chinese_thai", "choctaw", "cochiti", "colombian", "colombian_costa_rican", "colombian_mexican", "congolese", "costa_rican", "croatian", "croatian_montenegrin", "cuban", "cuban_french", "cuban_spanish", "curacaoan", "cypriot", "czech", "czech_ecuadorian", "czech_german", "czech_iraqi", "czech_swiss", "czechoslovakian", "danish", "danish_french", "danish_german", "danish_norwegian", "danish_taiwanese", "dine_navajo", "dominican", "dominican_uruguayan", "dutch", "dutch_french", "dutch_german", "dutch_hungarian", "dutch_indonesian", "dutch_italian", "dutch_new_zealand", "dutch_peruvian", "ecuadorian", "egyptian", "emirati", "english", "english_dutch", "english_german", "english_irish", "english_north_american", "eritrean", "estonian", "ethiopian", "fijians", "filipino", "filipino_french", "filipino_japanese", "finnish", "finnish_russian", "finnish_swedish", "flemish", "flemish_english", "flemish_italian", "french", "french_dominican", "french_german", "french_greek", "french_haitian", "french_hungarian", "french_indian", "french_iranian", "french_irish", "french_israeli", "french_italian", "french_japanese", "french_kenyan", "french_lebanese", "french_malagasy", "french_mexican", "french_moroccan", "french_peruvian", "french_polish", "french_portuguese", "french_romanian", "french_russian", "french_senegalese", "french_spanish", "french_sri_lankan", "french_swiss", "french_taiwanese", "french_tunisian", "french_turkish", "french_ukrainian", "french_venezuelan", "french_vietnamese", "gabonese", "gambian", "georgian", "georgian_german", "german", "german_egyptian", "german_eritrean", "german_hungarian", "german_iranian", "german_isreali", "german_italian", "german_korean", "german_mexican", "german_norwegian", "german_polish", "german_russian", "german_south_african", "german_spanish", "german_swiss", "german_turkish", "german_venezuelan", "ghanaian", "greek", "greek_italian", "greenlander", "guadeloupian", "guatemalan", "guyanese", "haida", "haitian", "hawaiian", "honduran", "hopi", "hungarian", "hungarian_swedish", "hungarian_swiss", "icelandic", "icelandic_italian", "indian", "indian_ukrainian", "indigenous_australian", "indonesian", "indonesian_malaysian", "indonesian_taiwanese", "inuit", "iranian", "iraqi", "irish", "irish_south_african", "islander", "israeli", "israeli_polish", "israeli_russian", "israeli_ukrainian", "italian", "italian_japanese", "italian_mexican", "italian_spanish", "italian_swiss", "italian_uruguayan", "ivorian", "jamaican", "japanese", "japanese_canadian", "japanese_finnish", "japanese_korean", "japanese_new_zealand", "japanese_swiss", "javanese", "jordanian", "kazakhstani", "kenyan", "kewa_pueblo", "kiowa", "korean", "kosovar", "kuwaiti", "kyrgyzstani", "laguna_pueblo", "lakota", "lao", "latvian", "lebanese", "lebanese_armenian", "lebanese_british", "liberian", "libyan", "liechtensteiner", "lithuanian", "lithuanian_uruguayan", "luxembourger", "macedonian", "malagasy", "malawian", "malaysian", "malian", "maltese", "maori", "martinican", "mauritian", "mexican", "mexican_israeli", "mexican_russian", "mexican_spanish", "moldavian", "monegasque", "mongolian", "montenegrin", "moroccan", "mozambican", "namibian", "native_american", "nepalese", "new_zealand", "new_zealand_scottish", "new_zealand_slovenian", "nicaraguan", "nigerian", "north_korean", "northern_irish", "norwegian", "norwegian_ghanaian", "oaxacan", "ojibwe", "omani", "pakistani", "palauan", "palestinian", "panamanian", "papuan", "paraguayan", "persian", "peruvian", "polish", "polish_ukrainian", "polish_venezuelan", "polynesian", "portuguese", "portuguese_chinese", "puerto_rican", "qatari", "romanian", "romanian_hungarian", "russian", "russian_italian", "russian_spanish", "russian_swedish", "russian_ukrainian", "rwandan", "saami", "saint_lucian", "salvadoran", "san_ildefonso_pueblo", "santa_clara_pueblo", "saudi_arabian", "scandinavian", "scottish", "scottish_tanzanian", "senegalese", "serbian", "sierra_leonean", "silesian", "singaporean", "slovakian", "slovenian", "somali", "somali_swedish", "sotho", "south_african", "spanish", "sri_lankan", "sudanese", "surinamese", "swazi", "swedish", "swedish_mexican", "swiss", "syrian", "tahitian", "taiwanese", "taiwanese_canadian", "tajikistani", "tanzanian", "tewa", "thai", "tibetan", "tlingit", "togolese", "trinidadian", "tunisian", "turkish", "turkmen", "ugandan", "ukrainian", "uruguayan", "uzbek", "venezuelan", "vietnamese", "welsh", "yemeni", "yugoslavian", "zambian", "zia", "zimbabwean", "zuni"; examples: ["british"])
- `currencies` (array) — Listing currencies (default: []; one of: "aud_dsbl", "cad", "chf", "dkk", "eur", "gbp", "hkd", "jpy", "nok", "sek", "usd", "zar"; examples: ["eur"])
- `sale_statuses` (array) — Sale statuses (default: []; one of: "bought_in", "contact_gallery", "for_sale", "not_available", "not_for_sale", "price_on_request", "reserved", "sold", "withdrawn"; examples: ["for_sale"])
- `price_min` (number, nullable) — Lowest price in US dollars (min: 0)
- `price_max` (number, nullable) — Highest price in US dollars (min: 0)
- `creation_year_min` (integer, nullable) — Earliest creation year (min: 0; max: 2100)
- `creation_year_max` (integer, nullable) — Latest creation year (min: 0; max: 2100)
- `artist_birth_year_min` (integer, nullable) — Earliest artist birth year (min: 0; max: 2100)
- `artist_birth_year_max` (integer, nullable) — Latest artist birth year (min: 0; max: 2100)
- `artist_death_year_min` (integer, nullable) — Earliest artist death year (min: 0; max: 2100)
- `artist_death_year_max` (integer, nullable) — Latest artist death year (min: 0; max: 2100)
- `size_min_cm` (number, nullable) — Shortest allowed longest edge, in cm (min: 0)
- `size_max_cm` (number, nullable) — Longest allowed longest edge, in cm (>: 0)
- `sale_date_from` (string, nullable) — Earliest sale date (format: date; examples: "2026-09-01")
- `sale_date_to` (string, nullable) — Latest sale date (format: date; examples: "2026-09-30")
- `has_image` (boolean, nullable) — Only artworks with or without an image
- `sort` (string) — Result order (default: "available_first"; one of: "available_first", "newest_created", "oldest_created", "recently_updated")
- `count` (integer, required) — Max number of artworks to return (min: 1; max: 1200)
- `gallery_id` (string, required) — Artnet gallery id (examples: "173540")
- `artist_ids` (array) — Artnet artist ids (default: []; examples: ["Artist_8315"])

## Response

### 200 — Successful Response

- `@type` (string) (default: "ArtnetArtwork")
- `id` (string, required)
- `listing_type` (string, nullable)
- `detail_id` (string, nullable)
- `url` (string, nullable)
- `image` (string, nullable)
- `artist_name` (string, nullable)
- `artist_attribution` (string, nullable)
- `medium` (string, nullable)
- `edition` (string, nullable)
- `creation_year_from` (integer, nullable)
- `creation_year_to` (integer, nullable)
- `dimensions_cm` (string, nullable)
- `dimensions_in` (string, nullable)
- `classification_ids` (array) (default: [])
- `status` (string, nullable)
- `institution` (object, nullable)
  - `@type` (string) (default: "ArtnetInstitution")
  - `id` (string, required)
  - `name` (string, nullable)
  - `alias` (string, nullable)
  - `kind` (string, nullable)
- `sale_name` (string, nullable)
- `lot_number` (string, nullable)
- `sale_start_date` (string, nullable)
- `sale_end_date` (string, nullable)
- `sale_starts_at` (integer, nullable)
- `sale_ends_at` (integer, nullable)
- `prices` (array) (default: [])
  - `@type` (string) (default: "ArtnetPrice")
  - `currency` (string, required)
  - `price_low` (number, nullable)
  - `price_high` (number, nullable)
  - `final_prices` (array) (default: [])
    - `@type` (string) (default: "ArtnetFinalPrice")
    - `kind` (string, required)
    - `price` (number, nullable)
    - `difference_from_estimate` (number, nullable)

## Errors

### 422 — Validation Error

The request body did not validate

What to do: Check the fields against this schema. A URN with the wrong prefix is the most common cause.

- `detail` (array)
  - `loc` (array, required)
  - `msg` (string, required)
  - `type` (string, required)
  - `input` (any)
  - `ctx` (object)

### 408

The request ran past its time limit

What to do: Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.

### 412

The entity was not found, or a precondition failed

What to do: Retrying will not help: either the entity does not exist, or the input points at a different one.

### 429

Too many requests: a rate limit or a usage window is exhausted

What to do: When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.

### 500

Something broke on our side

What to do: Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.

### 529

Rate limit reached, or the endpoint is overloaded

What to do: Wait at least 30 seconds, then retry.

## Response envelope

Success: Array of objects (may be empty if no results)

Error: Error may coexist with partial results if it occurs mid-execution. Check X-Error header and status code.

Every response carries these headers:

- `X-Error` — Error message text (present only on error)
- `X-Request-ID` — Unique request identifier
- `X-Execution-Time` — Execution time in seconds
- `X-Result-Count` — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
- `X-Total-Available-Results` — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
- `X-Warning` — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
- `X-Retry-After` — Seconds to wait before retrying. Present only on 429.