{"uid":"cap_-NUU307E76JJHTF7JK8p6","slug":"suverse-countries-now-states-lookup-3f61d76c","name":"Suverse Countries Now States Lookup","description":"Given a country name, return its full list of states or provinces with their subdivision codes. Free countriesnow.space data, no key. Useful for address forms, dropdowns, and geographic enrichment.","url":"https://proxy.suverse.io/v1/data/suverse-countries-cnow-states","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.055","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.055/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XNHUUuoLllHR76uEPpRbM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.055","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a country name, returns a full list of its states or provinces with their ISO subdivision codes.","exampleAgentPrompt":"Can you get me a full list of all the states and their subdivision codes for Brazil? I need it for populating a country/state dropdown in our address form.","exampleUseCases":[{"title":"Address form state dropdown","prompt":"I'm building an address form for our checkout page — can you pull the full list of states and their codes for Canada so I can populate the province dropdown?"},{"title":"Geographic enrichment for user data","prompt":"We have users from India in our database and need to validate their state field. Can you fetch all the states and subdivision codes for India so I can cross-check them?"},{"title":"Country region selector for app","prompt":"Our app needs to let users pick their region when they sign up. Can you get all the states or provinces for Australia with their codes so I can build that selector?"}],"resultDescription":"A list of states or provinces belonging to the specified country, each with its name and ISO subdivision code, suitable for use in address forms, dropdowns, or geographic data enrichment.","failureModes":["Country name not recognized or misspelled — returns empty list or error","Network timeout if upstream countriesnow.space is slow","Invalid or missing input body — returns 400 bad request","Country with no subdivisions returns empty array","Payment failure if x402 USDC payment not completed"],"whenToPreferThis":"Choose this endpoint when you need a reliable, free-tier list of states or provinces with their official subdivision codes for a given country, especially for populating address form dropdowns or enriching geographic data. Prefer it over manual lookup or scraping when you need structured, code-labeled subdivision data quickly without managing an API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T12:41:44.647Z","isFirstParty":false}