{"openapi":"3.1.0","info":{"title":"Mock Data API","version":"1.0.0","description":"Generate realistic fake data — users, postal addresses, companies and products — for testing, prototyping, demos and database seeding. Localizable to many languages and regions for names, addresses and phone numbers. Server-side and deterministic to call, ideal for CI fixtures and frontend mock states.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mockdata-api","description":"oanor gateway"}],"tags":[{"name":"Mock Data"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/addresses":{"get":{"operationId":"get_v1_addresses","tags":["Mock Data"],"summary":"Fake postal addresses","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many to generate, 1-100","schema":{"type":"string"},"example":"5"},{"name":"locale","in":"query","required":false,"description":"Faker locale (de, fr, es, en_US …)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"results":[{"zip":"81791-9600","city":"Eddiefield","state":"Georgia","street":"7419 Alf Radial","country":"Republic of Korea","latitude":-40.7032,"timezone":"Atlantic/Cape_Verde","longitude":-0.3393,"secondary":"Apt. 205","country_code":"GS"},{"zip":"21757-2081","city":"Stiedemannview","state":"Colorado","street":"90379 MacGyver Mews","country":"Guernsey","latitude":56.7737,"timezone":"Africa/Banjul","longitude":14.9099,"secondary":"Suite 215","country_code":"MV"},{"zip":"92607","city":"Brandon","state":"Kansas","street":"6124 Noelia Throughway","country":"Sudan","latitude":-75.7492,"timezone":"America/Lower_Princes","longitude":-93.754,"secondary":"Apt. 231","country_code":"VI"},{"zip":"13020","city":"Fort Ola","state":"South Carolina","street":"74393 Woodlands","country":"India","latitude":5.3269,"timezone":"Asia/Dili","longitude":139.8981,"secondary":"Suite 463","country_code":"WS"},{"zip":"94789-1654","city":"Port Elissa","state":"Arizona","street":"927 Theo Prairie","country":"Wallis and Futuna","latitude":34.9934,"timezone":"Europe/Tirane","longitude":-114.9849,"secondary":"Apt. 569","country_code":"UM"}]},"meta":{"timestamp":"2026-05-30T06:51:40.487Z","request_id":"2763e4ce-8e14-45c1-944a-ab8349987ad2"},"status":"ok","message":"Addresses generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/companies":{"get":{"operationId":"get_v1_companies","tags":["Mock Data"],"summary":"Fake companies","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many to generate, 1-100","schema":{"type":"string"},"example":"5"},{"name":"locale","in":"query","required":false,"description":"Faker locale (de, fr, es, en_US …)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"results":[{"url":"https://youthful-produce.com/","buzz":"disintermediate best-of-breed content","name":"Gutmann, Schneider and O'Kon","email":"danielle.wintheiser29@yahoo.com","phone":"1-344-795-4196 x49249","address":{"city":"Fort Madisynchester","country":"Palau"},"industry":"Garden","catchphrase":"Stand-alone transitional hub"},{"url":"https://snoopy-zebra.org/","buzz":"repurpose B2B solutions","name":"Rodriguez - Jacobson","email":"elaina_robel23@gmail.com","phone":"329-252-7804 x1831","address":{"city":"Conway","country":"Comoros"},"industry":"Home","catchphrase":"Horizontal fault-tolerant intranet"},{"url":"https://artistic-intellect.name/","buzz":"grow cross-platform large language models","name":"Moen LLC","email":"laurie_kuhic70@gmail.com","phone":"1-940-453-0338 x451","address":{"city":"North Amie","country":"South Africa"},"industry":"Clothing","catchphrase":"Public-key heuristic local area network"},{"url":"https://measly-scenario.net/","buzz":"revolutionize distributed ROI","name":"Bradtke, Jerde and Goodwin","email":"isai_spencer56@gmail.com","phone":"(640) 356-0919 x9698","address":{"city":"Boganfort","country":"Chile"},"industry":"Games","catchphrase":"Distributed maximized model"},{"url":"https://devoted-acquaintance.name","buzz":"deploy sticky supply-chains","name":"Mueller - Wolff","email":"zaria.davis@yahoo.com","phone":"(252) 883-2906","address":{"city":"Schmidtton","country":"Tuvalu"},"industry":"Beauty","catchphrase":"Secured uniform monitoring"}]},"meta":{"timestamp":"2026-05-30T06:51:40.567Z","request_id":"70ed04a2-8732-4927-924e-2bc05abb91df"},"status":"ok","message":"Companies generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/products":{"get":{"operationId":"get_v1_products","tags":["Mock Data"],"summary":"Fake products","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many to generate, 1-100","schema":{"type":"string"},"example":"5"},{"name":"locale","in":"query","required":false,"description":"Faker locale (de, fr, es, en_US …)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"results":[{"id":"7a31868f-1e19-4b16-953e-6c523cfefa0e","sku":"DA09AUV0US","name":"Ergonomic Wooden Computer","price":638.89,"currency":"USD","in_stock":true,"material":"Bronze","department":"Automotive","description":"Featuring Protactinium-enhanced technology, our Bacon offers unparalleled tame performance"},{"id":"1db4dfad-4995-4610-abfa-ab10e06901bd","sku":"LZO48XKHHF","name":"Luxurious Granite Tuna","price":350.39,"currency":"USD","in_stock":true,"material":"Metal","department":"Grocery","description":"New Car model with 18 GB RAM, 984 GB storage, and acclaimed features"},{"id":"552da019-a513-4ac1-aab0-12923d0f54ee","sku":"B418DAWX2S","name":"Rustic Silk Car","price":883.29,"currency":"USD","in_stock":false,"material":"Ceramic","department":"Kids","description":"The Kayli Bike is the latest in a series of other products from Cremin - MacGyver"},{"id":"eb5d1d11-46e0-4db8-a045-9e4834e77854","sku":"HPHTYXYDFI","name":"Electronic Bamboo Soap","price":383.99,"currency":"USD","in_stock":false,"material":"Ceramic","department":"Automotive","description":"Innovative Keyboard featuring phony technology and Granite construction"},{"id":"fbd9932f-268d-49dd-aacc-c844374e2b90","sku":"KHAZ0GKGZC","name":"Elegant Aluminum Cheese","price":742.39,"currency":"USD","in_stock":false,"material":"Silk","department":"Health","description":"The Digitized methodical knowledge base Gloves offers reliable performance and actual design"}]},"meta":{"timestamp":"2026-05-30T06:51:40.636Z","request_id":"f94b01d3-97da-46b6-a5e8-6956c4aecf7f"},"status":"ok","message":"Products generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/users":{"get":{"operationId":"get_v1_users","tags":["Mock Data"],"summary":"Fake user profiles","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"How many to generate, 1-100","schema":{"type":"string"},"example":"5"},{"name":"locale","in":"query","required":false,"description":"Faker locale (de, fr, es, en_US …)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"results":[{"id":"f969ca74-ef17-46f9-8557-7680a20365f0","email":"sabrina.bauch64@yahoo.com","phone":"722.622.6135 x5231","avatar":"https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/85.jpg","gender":"female","address":{"zip":"92554","city":"Anchorage","state":"Tennessee","street":"373 E Central Avenue","country":"Turkey"},"username":"Sabrina.Bauch32","birthdate":"1964-06-23","full_name":"Sabrina Bauch","job_title":"Regional Interactions Producer","last_name":"Bauch","first_name":"Sabrina"},{"id":"8d7ff7ff-63f8-41ed-8be3-a124fcee7585","email":"timmy.mcdermott37@hotmail.com","phone":"1-716-261-4126 x12039","avatar":"https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/male/512/90.jpg","gender":"male","address":{"zip":"31618-2031","city":"East Alexiestead","state":"Kansas","street":"296 Howard Road","country":"Eritrea"},"username":"Timmy_McDermott","birthdate":"2005-01-09","full_name":"Timmy McDermott","job_title":"Central Accounts Engineer","last_name":"McDermott","first_name":"Timmy"},{"id":"4073e259-7db2-47a3-8a59-815ee731d5ef","email":"jeffery_white10@yahoo.com","phone":"1-856-393-0490 x186","avatar":"https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/27.jpg","gender":"male","address":{"zip":"24983-1885","city":"Watsicashire","state":"Oregon","street":"525 Market Square","country":"Tonga"},"username":"Jeffery.White87","birthdate":"1986-05-08","full_name":"Jeffery White","job_title":"Chief Security Developer","last_name":"White","first_name":"Jeffery"},{"id":"906d553c-2200-4c67-9a50-412753da32cb","email":"tommy_hayes17@gmail.com","phone":"737.327.7556 x3675","avatar":"https://avatars.githubusercontent.com/u/18638252","gender":"male","address":{"zip":"31407-2685","city":"East Chelseaview","state":"Colorado","street":"432 Susie Ports","country":"Turks and Caicos Islands"},"username":"Tommy_Hayes58","birthdate":"1967-12-09","full_name":"Tommy Hayes","job_title":"District Usability Architect","last_name":"Hayes","first_name":"Tommy"},{"id":"f69ae3ff-48f4-4873-a18c-bb84f27be693","email":"ollie_hettinger97@gmail.com","phone":"1-874-698-9612 x581","avatar":"https://cdn.jsdelivr.net/gh/faker-js/assets-person-portrait/female/512/41.jpg","gender":"female","address":{"zip":"81639","city":"East Providence","state":"Kentucky","street":"8503 Bayer Loop","country":"Cape Verde"},"username":"Ollie_Hettinger39","birthdate":"1971-01-19","full_name":"Ollie Hettinger","job_title":"International Assurance Associate","last_name":"Hettinger","first_name":"Ollie"}]},"meta":{"timestamp":"2026-05-30T06:51:40.704Z","request_id":"6c264b52-b3b2-4245-afcf-9e4837d3f38b"},"status":"ok","message":"Users generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":400,"monthly_call_quota":150000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":750000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3900,"monthly_call_quota":4000000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mockdata-api"}