{"uid":"cap_P4lxWehwe0Jv7o69jlYvK","slug":"us-state-territory-lookup-143f1f62","name":"US State & Territory Lookup","description":"Look up a US state or territory by name, postal abbreviation or FIPS code: all three, region, division and capital.","url":"https://geo-us.x402tookit.com/us-state-info?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["state"],"properties":{"state":{"type":"string","description":"Name, abbreviation or FIPS, e.g. Ohio, OH or 39"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"abbr":{"type":["null","string"]},"asOf":{"type":["null","string"]},"fips":{"type":["null","string"]},"name":{"type":["null","string"]},"region":{"type":["null","string"]},"source":{"type":["null","string"]},"capital":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"division":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hC2-1hMbHJG1-K6qmRk_z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns name, postal abbreviation, FIPS code, region, division, and capital for any US state or territory identified by name, abbreviation, or FIPS code.","exampleAgentPrompt":"What's the census region, division, and capital for Ohio? I have the state name, but I could also use its FIPS code 39 or abbreviation OH.","exampleUseCases":[{"title":"Normalize state abbreviation to full name","prompt":"I have the postal abbreviation 'CA' from a form submission — can you look up the full state name, FIPS code, and what census region and division it belongs to?"},{"title":"Validate and enrich FIPS code in dataset","prompt":"I've got FIPS code 48 in my dataset and I need to confirm which state that is, along with its abbreviation, census region, and capital city."},{"title":"Get census division for state-level reporting","prompt":"For my report I need to know what census division and region Virginia falls into — can you look it up along with its capital and FIPS code?"}],"resultDescription":"Returns a JSON object with the state's full name, postal abbreviation, FIPS code, census region (e.g. South), census division (e.g. East South Central), and capital city. Also includes metadata such as data source and as-of date. May include a degraded flag and reasons if the response is partial.","failureModes":["Unrecognized state input returns an error or empty result — e.g. misspelled name or invalid FIPS code","Territories (e.g. Guam, Puerto Rico) may return null for some fields like division if not applicable","Ambiguous abbreviations could match multiple entries if not a standard postal code","Network or payment failure returns a 402 or 5xx error with no data"],"whenToPreferThis":"Use this endpoint when you need to resolve or enrich a US state identifier — whether you have a name, abbreviation, or FIPS code — and need the corresponding census region, division, capital, or normalized identifiers. Prefer this over general geocoding endpoints when working with state-level administrative or census data rather than addresses or coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:14:28.248Z","isFirstParty":false,"canonicalSlug":"us-state-territory-lookup-143f1f62"}