{"openapi":"3.1.0","info":{"title":"collectibles.bid API","version":"1.0.0","description":"Public, read-only access to collectibles.bid (collectibles markets, India) plus a ready-filled listing link the seller submits themselves."},"servers":[{"url":"https://cards.collectibles.bid"}],"paths":{"/api/v1/listings":{"get":{"operationId":"searchListings","summary":"Items open for offers","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"max_price","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/listings/{id}":{"get":{"operationId":"getListing","summary":"One listing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/prices":{"get":{"operationId":"priceCheck","summary":"Real sold prices","parameters":[{"name":"category","in":"query","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/categories":{"get":{"operationId":"categories","summary":"Categories and conditions","responses":{"200":{"description":"OK"}}}},"/api/v1/draft":{"post":{"operationId":"prepareListing","summary":"Ready-filled listing link (nothing stored)","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["coins_british","coins_mughal","coins_republic","coins_notes","coins_world","coins_bullion","stamps_india","stamps_british","stamps_world","stamps_covers","stamps_postcards","stamps_lots","cards_cricket","cards_sports","cards_game","cards_graded","cards_vintage","cards_sealed","sports_bats","sports_shirts","sports_balls","sports_autographs","sports_tickets","sports_trophies","antiques_clocks","antiques_brass","antiques_music","antiques_cameras","antiques_decor","antiques_other","toys_diecast","toys_trains","toys_tin","toys_soft","toys_robots","toys_wooden"],"description":"coins_british = British India coins (Victoria to George VI rupees, annas and pice); coins_mughal = Mughal & princely states (Mughal mohurs and rupees, Hyderabad, Mysore, Travancore and other states); coins_republic = Republic of India coins (Anna series, early paise, commemoratives, errors); coins_notes = Banknotes (Old and fancy-number notes, British India and Republic); coins_world = World coins (Coins from other countries); coins_bullion = Gold & silver coins and medals (Bullion coins, mint sets, medals and tokens); stamps_india = Indian stamps (Republic of India stamps, sheets and miniature sheets); stamps_british = British India & princely states (Pre-1947 stamps, convention and feudatory states); stamps_world = World stamps (Stamps from other countries); stamps_covers = Covers & first day covers (FDCs, postal history, special covers); stamps_postcards = Postcards & ephemera (Old postcards, letters, tickets and paper); stamps_lots = Albums & lots (Whole collections, albums and mixed lots); cards_cricket = Cricket cards (Cricket trading cards and stickers); cards_sports = Other sports cards (Football, basketball, baseball and more); cards_game = Game cards (Collectible card games, single cards and decks); cards_graded = Graded cards (Cards in grading slabs); cards_vintage = Vintage cards (Cards printed before 2000); cards_sealed = Sealed packs & boxes (Unopened packs, boxes and sets); sports_bats = Bats & rackets (Signed and match-used bats, rackets and sticks); sports_shirts = Jerseys & shirts (Signed and match-worn shirts); sports_balls = Balls (Signed and match balls); sports_autographs = Autographs & photos (Signed photos, books and cards); sports_tickets = Tickets & programmes (Match tickets, scorecards and programmes); sports_trophies = Trophies, medals & other (Medals, caps, trophies and other memorabilia); antiques_clocks = Clocks & watches (Wall, table and pocket clocks); antiques_brass = Brass, bronze & copper (Lamps, vessels, figures and tools); antiques_music = Gramophones, radios & records (Gramophones, valve radios, records); antiques_cameras = Cameras & typewriters (Film cameras, lenses, typewriters); antiques_decor = Lamps, vases & decor (Glass, porcelain, lamps and mirrors); antiques_other = Furniture & other (Furniture, boxes, tools and curios); toys_diecast = Die-cast models (Cars, bikes, aircraft and trucks); toys_trains = Model trains (Trains, tracks and accessories); toys_tin = Tin & wind-up toys (Vintage tin and clockwork toys); toys_soft = Soft toys & dolls (Teddy bears, dolls and plush); toys_robots = Robots & figures (Robots, figures and space toys); toys_wooden = Wooden & traditional toys (Channapatna, Kondapalli and other wooden toys)"},"brand":{"type":"string","description":"Maker, issuer or country."},"model":{"type":"string","description":"Short title, e.g. George V silver rupee 1918."},"reference":{"type":"string","description":"Year or period, e.g. 1918."},"year":{"type":"string","description":"Not used."},"condition":{"type":"string","enum":["mint","xf","vf","fine","worn"]},"location":{"type":"string","description":"City it ships from."},"start_price":{"type":"integer","description":"Offers-from price in ₹."},"description":{"type":"string","description":"Honest description: condition, faults, proof of authenticity. No phone numbers or links."}},"required":["category","brand","model"]}}}},"responses":{"200":{"description":"OK"}}}}}}