{"uid":"cap_bb1ZuT-mSdJvjAo_zyl8K","slug":"random-integer-generator-openverbs-60115702","name":"Random Integer Generator (OpenVerbs)","description":"Generate one or more uniformly-distributed random integers in an inclusive [min, max] range.","url":"https://random.openverbs.com/v1/integer","method":"POST","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"type":"object","properties":{"min":{"type":"integer","description":"Inclusive lower bound."},"max":{"type":"integer","description":"Inclusive upper bound (>= min)."},"count":{"type":"integer","minimum":1,"maximum":1000,"description":"How many integers. Default 1."}},"required":["min","max"],"additionalProperties":false}},"required":["type","method","bodyType","body"],"additionalProperties":false}},"required":["input"]},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_py8QRepxAy_4lGBYz2_iK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates one or more uniformly-distributed random integers within a user-specified inclusive [min, max] range.","exampleAgentPrompt":"Give me 5 random integers between 1 and 100.","exampleUseCases":[{"title":"Simulating dice rolls for a game","prompt":"Roll 3 six-sided dice for me — give me 3 random numbers between 1 and 6."},{"title":"Picking random winners for a giveaway","prompt":"I have 250 contestants numbered 1 through 250 — pick 5 random winner numbers for my giveaway."},{"title":"Generating random test data IDs","prompt":"I need 20 random integers between 10000 and 99999 to use as test user IDs in my staging environment."}],"resultDescription":"Returns one or more random integers sampled uniformly from the inclusive [min, max] range. When count is 1 (default), a single integer is returned; when count > 1, an array of up to 1000 integers is returned.","failureModes":["min greater than max — request rejected with validation error","count outside 1–1000 range — rejected with schema validation error","non-integer values for min, max, or count — type error returned","missing required min or max field — 400 bad request","payment failure or insufficient USDC balance — 402 payment required"],"whenToPreferThis":"Choose this endpoint when you need uniformly-distributed random integers with a well-defined inclusive range and optional batch generation (up to 1000 at once). It is ideal for simulations, games, giveaways, test data generation, and any scenario requiring reproducible randomness characteristics. Prefer it over general-purpose code execution for randomness when you want a lightweight, pay-per-call approach without spinning up compute. Use the sibling random bytes endpoint if you need cryptographic randomness, or the array-sampling endpoint if you need to draw from a known set.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:28.053Z","isFirstParty":false}