{"uid":"cap_qhWo8ic44nQId411w02i2","slug":"us-state-dc-territory-lookup-by-postal-code-name-or-fips-cacf3d45","name":"US State, DC & Territory Lookup by Postal Code, Name, or FIPS","description":"US state, DC and territory lookup by USPS postal code, name or FIPS number; returns all three plus the type.","url":"https://country-codes-iso.x402tookit.com/us-state-code?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":["q"],"properties":{"q":{"type":"string","description":"Postal code, name or FIPS: CO, Colorado, 08"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"state":{"type":["null","object"],"properties":{"fips":{"type":["null","string"]},"kind":{"type":["null","string"]},"name":{"type":["null","string"]},"postal":{"type":["null","string"]}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"matchedOn":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","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_Z8OYhevil-0TXEt51KHjR","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":"Looks up a US state, DC, or territory by USPS postal code, full name, or FIPS number and returns all three identifiers plus the entity type.","exampleAgentPrompt":"What is the FIPS code and full name for the US state with postal code CO?","exampleUseCases":[{"title":"Resolving FIPS code for compliance reporting","prompt":"I need the FIPS number and official name for Texas — we have to use it in a federal compliance report and I only have the two-letter abbreviation TX."},{"title":"Identifying territory type for address validation","prompt":"Is Guam a state or territory? Look it up by its postal code GU and tell me its FIPS code and what kind of entity it is."},{"title":"Converting FIPS number to state identifiers","prompt":"I have FIPS number 08 and need to know which US state or territory that maps to — give me the full name and USPS postal code."}],"resultDescription":"Returns an object containing the matched entity's USPS postal code, full official name, FIPS number, and kind (e.g. state, territory, district), along with metadata about what field was matched on, source attribution, and a summary.","failureModes":["Invalid or unrecognized query string returns a null state object with reasons explaining the mismatch","Ambiguous input (e.g. a number that could match multiple FIPS codes) may return degraded results with a matchedOn field explaining partial resolution","Network or service errors result in a non-200 response with no state data"],"whenToPreferThis":"Use this endpoint when you need to cross-reference or normalize US state, DC, or territory identifiers — specifically to convert between USPS postal codes, full names, and FIPS numbers in one call. It also returns the entity type (state vs territory vs DC), making it more informative than a simple abbreviation lookup table. Prefer this over general country-code endpoints when the lookup is specifically for US subnational divisions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:32:22.327Z","isFirstParty":false,"canonicalSlug":"us-state-dc-territory-lookup-by-postal-code-name-or-fips-cacf3d45"}