{"openapi":"3.0.3","info":{"title":"Feed America API","description":"API for finding food assistance resources across all 50 US states, DC, Puerto Rico, and US territories. 321K+ locations including food pantries, food banks, soup kitchens, mobile pantries, community fridges, SNAP retailers, WIC offices, school/summer meal sites, and FQHC community health centers.","version":"2.1.0","contact":{"email":"info@feedam.org","url":"https://feedam.org"}},"servers":[{"url":"https://feedam.org","description":"Production (canonical apex; workers.dev origin auto-301s here)"}],"paths":{"/api/llm-search":{"get":{"summary":"Natural-language search for AI assistants. Accepts free-form English queries and extracts location + mode + urgency automatically. Designed for OpenAI Custom GPTs, Claude Tools, Perplexity custom actions. CORS-enabled for browser AI clients.","operationId":"llmSearch","parameters":[{"name":"q","in":"query","required":true,"description":"Free-form English (or Spanish) query about food assistance. Examples: \"I need food today in Houston\", \"free food pantry near 77065\", \"WIC clinic near 90001\", \"How do I apply for SNAP in Texas\".","schema":{"type":"string"}}],"responses":{"200":{"description":"Search results with structured intent + natural-language answer","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"The original input query"},"intent":{"type":"object","description":"Extracted intent: location, mode, urgency, action","properties":{"location":{"type":"string","description":"5-digit ZIP or \"City, ST\""},"state":{"type":"string","description":"2-letter US state code"},"mode":{"type":"string","enum":["free","snap","wic","school","summer"]},"urgent":{"type":"boolean"},"intent":{"type":"string","enum":["find","apply"]}}},"answer":{"type":"string","description":"Natural-language answer the AI can return verbatim or rephrase"},"action":{"type":"string","description":"What the response represents: search_results | apply_snap | apply_wic | need_location"},"result_count":{"type":"integer"},"total_available":{"type":"integer"},"resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"type":{"type":"string"},"address":{"type":"string"},"phone":{"type":"string","nullable":true},"distance_miles":{"type":"number","nullable":true},"open_status":{"type":"string","enum":["open","closed","closes_soon","opens_soon","unknown"]},"feedam_detail_url":{"type":"string","format":"uri"}}}},"related_links":{"type":"object","description":"Useful follow-up URLs the AI can offer"},"attribution":{"type":"string"}}}}}}}}},"/api/resources/search":{"get":{"summary":"Search resources by ZIP or city. Params: zip, mode (free|snap|school|summer|wic|health), type, radius, limit. Returns relevance_score, hours_status, total_available, and auto-expands the radius when zero results within 50mi."}},"/api/resources/nearby":{"get":{"summary":"Search by lat/lng directly. Params: lat, lng, mode, radius, limit."}},"/api/resources/urgent":{"get":{"summary":"Currently-open free food resources. Params: zip or lat/lng, radius."}},"/api/resources/counts":{"get":{"summary":"Per-mode result counts within 150mi of a ZIP. Use before searching so you can show users \"Free Food (47), SNAP (183), Health Centers (2)\" etc. Returns {free, snap, school, summer, wic, health}. 300s cache."}},"/api/resources/{id}":{"get":{"summary":"Single resource with hours_status."}},"/api/resources/{id}/status":{"get":{"summary":"Phone validation, hours status, verification confidence."}},"/api/resources/types":{"get":{"summary":"All resource categories with counts."}},"/api/resources/bulk":{"get":{"summary":"Paginated export (JSON/CSV). Params: page, limit (max 1000), format, state, type."}},"/api/autocomplete":{"get":{"summary":"City name autocomplete. Param: q (min 2 chars)."}},"/api/stats":{"get":{"summary":"Live database statistics."}},"/api/stats/quality":{"get":{"summary":"Verification rates and freshness metrics."}},"/api/feedback":{"post":{"summary":"Submit feedback (helpful|wrong_info|closed|other)."}},"/api/partner/find":{"get":{"summary":"Find your listing. Params: name, zip."}},"/api/partner/edit":{"post":{"summary":"Submit edit for review. Body: resource_id, changes, submitted_by."}},"/api/sms":{"post":{"summary":"Twilio-compatible SMS webhook. Send ZIP to get 3 nearest resources."}},"/api/widget":{"get":{"summary":"Embeddable HTML food finder widget. Param: zip."}},"/api/analytics/dashboard":{"get":{"summary":"Search analytics: daily counts, top ZIPs, zero-result searches."}},"/api/snap/calculate":{"post":{"summary":"SNAP benefit calculator (2024-2025 USDA tables)."}},"/api/health":{"get":{"summary":"Health check."}},"/api/health/deep":{"get":{"summary":"Deep health check with DB connectivity test."}},"/llms.txt":{"get":{"summary":"LLM-friendly API summary with live counts, endpoint list, and data sources."}},"/llms-full.txt":{"get":{"summary":"Full-data LLM text export: per-category records with address and phone, up to 200 per category."}},"/sitemap.xml":{"get":{"summary":"Dynamic sitemap including state + long-tail city food-pantry landing pages."}},"/hsds/v3/":{"get":{"summary":"HSDS 3.0 Open Referral feed landing page (HTML). See also /hsds/v3/datapackage.json for the Frictionless Data descriptor. 10 entity endpoints: organizations, services, locations, service_at_location, phones, addresses, schedules, languages, taxonomy_terms, attributes."}},"/hsds/v3/datapackage.json":{"get":{"summary":"HSDS 3.0 data package descriptor (Frictionless Data format) listing all resource URLs, schemas, and license info."}},"/hsds/v3/organizations":{"get":{"summary":"HSDS Organization entities. Params: page, per_page (max 1000), format (json|csv). ~143k records."}},"/hsds/v3/services":{"get":{"summary":"HSDS Service entities — one per active resource. ~200k records."}},"/hsds/v3/locations":{"get":{"summary":"HSDS Location entities — physical location with lat/lng. ~200k records."}},"/hsds/v3/service_at_location":{"get":{"summary":"HSDS ServiceAtLocation joins. ~200k records."}},"/hsds/v3/phones":{"get":{"summary":"HSDS Phone entities. ~147k records with phone number."}},"/hsds/v3/addresses":{"get":{"summary":"HSDS Address entities. ~200k records."}},"/hsds/v3/schedules":{"get":{"summary":"HSDS Schedule entities with iCal RRULE fields (freq, byday, opens_at, closes_at). ~128k records with hours."}},"/hsds/v3/languages":{"get":{"summary":"HSDS Language entities per service. ~124k records."}},"/hsds/v3/taxonomy_terms":{"get":{"summary":"HSDS TaxonomyTerm entities — 11 food-assistance category terms."}},"/hsds/v3/attributes":{"get":{"summary":"HSDS Attribute entities mapping services to taxonomy terms. One per active resource."}},"/api/pantry/search":{"get":{"summary":"Find claimable pantries for an operator. Params: zip (required, 5-digit), q (optional partial name). Returns up to 25 within 5mi."}},"/api/pantry/claim":{"post":{"summary":"Mint a claim token for a pantry. Body: {resource_id, operator_email, operator_phone, operator_name}. Returns {claim_token, dashboard_url}. Idempotent per (resource_id, email)."}},"/api/pantry/manage/{token}":{"get":{"summary":"Operator dashboard data: claim + resource + recent statuses + current live status. Auth: token in URL path."}},"/api/pantry/status":{"post":{"summary":"Push a live status update. Body: {claim_token, status, notes, inventory}. status ∈ [open_today, closed_today, running_late, low_stock, out_of_stock, other]. Inventory: {produce, dairy, canned, protein, baby, water, bread, other} × {plenty, low, out}. 24h TTL."}},"/api/pantry/{id}/status":{"get":{"summary":"Public read — current (non-expired) live status for a resource. 60s cache. Returns null if no active report."}},"/api/disasters/active":{"get":{"summary":"Currently-active FEMA declarations in a ZIP or state. Params: zip (5-digit) OR state (2-letter). Returns declarations + has_dsnap_likely flag."}},"/api/disasters/current":{"get":{"summary":"All currently-open FEMA declarations nationally. No filter. 5-min cache."}},"/api/submissions":{"post":{"summary":"Public crowdsourced pantry submission. Body: {name, address, city, state, zip, resource_type, phone?, website?, hours_text?, services_offered?, requirements_text?, submitter_email?, submitter_name?, submitter_relationship?}. Validates input, dedups by name+zip (409 on duplicate), rate-limits 5/hour per IP. Writes to resources table with is_active=0, verification_status=pending until admin reviews."}},"/api/embed/pantry/{id}.json":{"get":{"summary":"Single-pantry data for partner mobile apps + custom dashboards. Returns name, address, hours_status, phone, badges + embed/detail/directions URLs."}},"/api/embed/catalog.json":{"get":{"summary":"Comprehensive catalog of all Feed America embeddable surfaces (search widget, pantry card, badges, OG cards, JSON APIs, HSDS feed, WordPress plugin, MCP server). 9 items."}},"/atlas.json":{"get":{"summary":"State-by-state hunger atlas snapshot. National totals + per-state counts (food_pantries, food_banks, soup_kitchens, mobile_pantries, wic_clinics, school_meal_sites, summer_meal_sites, fqhc_health_centers, snap_retailers, partner_verified). 1h cache. CC BY 4.0."}},"/api/leaderboard.json":{"get":{"summary":"State-by-state ranking of partner-verified pantries. National totals + ranked array. 10-min cache. CC BY 4.0."}},"/about.json":{"get":{"summary":"Machine-readable About page: organization identity, coverage, data sources, contact, verification, sister entities, disambiguation, products, machine-readable endpoints. v1.0 stable schema."}},"/donate.json":{"get":{"summary":"Machine-readable donation metadata: organization, mailing address, 10 donation channels (online/mail/DAF/stock/crypto/employer/wire/QCD/bequest/recurring), sister entities, disambiguation. v1.0."}},"/snapshot.json":{"get":{"summary":"Single-pull comprehensive Feed America snapshot. Aggregates org + coverage totals + top 10 states by partner-verified + top 10 cities by pantry density + 14 discovery URLs + 9 quick-action URL templates. Saves 5-6 round-trips."}},"/press/feed.json":{"get":{"summary":"JSON Feed (jsonfeed.org/version/1.1) of Feed America press releases. Subscribers: journalists, dev tools that prefer JSON over RSS."}},"/press/feed.atom":{"get":{"summary":"Atom feed of Feed America press releases. Subscribers: news aggregators, RSS readers."}},"/.well-known/security.txt":{"get":{"summary":"RFC 9116 security contact info for vulnerability researchers. Auto-discovered by responsible-disclosure tooling."}},"/security":{"get":{"summary":"Security policy + responsible-disclosure program HTML page. Pairs with /.well-known/security.txt."}},"/atlas/{state}.json":{"get":{"summary":"Per-state hunger atlas JSON snapshot. State, coverage (food_pantry_class subtotal + 5 federal-program counts + SNAP retailers), verification, geographic, top_cities_by_pantry_count, related_surfaces (8 URLs), org. Returns 404 for unknown 2-letter state code."}},"/api/v1/health.json":{"get":{"summary":"Comprehensive public health endpoint. Returns service status, table row counts, verification breakdown, data freshness distribution, coverage totals, discovery URLs. 60s cache for monitoring services."}},"/api/v1/ai-tools.json":{"get":{"summary":"Master AI integration manifest: MCP + OpenAPI + AI plugin protocols, 41+ machine-readable JSON endpoints, 4 text discovery files, 16 Schema.org types, 8 audience-matched start URLs. The single endpoint AI agents hit first to discover what Feed America offers programmatically."}},"/api/v1/intents.json":{"get":{"summary":"Intent vocabulary for AI agents — example_phrasings → canonical_action mapping. 30-min cache."}},"/api/v1/qa.json":{"get":{"summary":"English canonical Q&A pairs for AI / chatbot ingestion. Org identity, EIN disambiguation, finding food, applying for SNAP/WIC, D-SNAP, donation, legitimacy. FAQPage Schema.org markup. 30-min cache."}},"/api/v1/sitemap.json":{"get":{"summary":"Machine-readable sitemap of every indexable Feed America surface. 30-min cache."}},"/api/v1/state/{state}.json":{"get":{"summary":"Per-state canonical data dump for AI agents (51 surfaces). State stats, top cities, federal program portals, disaster status. 30-min cache."}},"/api/v1/types.json":{"get":{"summary":"Resource type catalog: food_pantry, food_bank, soup_kitchen, mobile_pantry, community_fridge, emergency, wic_office, snap_office, school_meal, summer_meal, health_center, tribal_food, senior_commodity, rmp_restaurant, head_start, diaper_bank, mental_health_facility, ryan_white_provider, opioid_treatment, rural_health_clinic."}},"/api/v1/coverage.json":{"get":{"summary":"Per-state coverage gap analysis. Returns 51 states ranked by resources_per_1000_residents with tier classification (sparse/fair/good) and methodology disclosure. Designed for journalists, foundations, and AI agents identifying underserved states. Population data from 2024 US Census ACS.","operationId":"coverageAnalysis","responses":{"200":{"description":"Ranked array of states + national rollup + tier counts.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/verify/{ein}":{"get":{"summary":"Answer-card for \"is this Feed America?\". Given a 9-digit EIN (with or without hyphen), returns is_feed_america boolean + canonical identity card. Recognizes Feed America (92-1761881), sister entities Feeding America Texas (92-1776845) and Feeding America Florida (93-3176598), and the separate Chicago org Feeding America (36-3673599). Replaces defensive HTML pages; AI agents call this directly to disambiguate. 24h cache.","operationId":"verifyEin","parameters":[{"name":"ein","in":"path","required":true,"description":"9-digit IRS EIN, with or without hyphen. Example: 92-1761881 or 921761881.","schema":{"type":"string"}}],"responses":{"200":{"description":"Known entity — returns identity card.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object"},"result":{"type":"object","properties":{"is_feed_america":{"type":"boolean"},"is_primary":{"type":"boolean"},"name":{"type":"string"},"ein":{"type":"string"},"classification":{"type":"string"},"headquarters":{"type":"object"},"verification_urls":{"type":"object"}}}}}}}},"400":{"description":"Invalid EIN format (must be 9 digits)."},"404":{"description":"Unknown EIN — returns hint URL to IRS lookup."}}}},"/api/v1/data-quality.json":{"get":{"summary":"Comprehensive data-quality QA report. Field completeness % per pantry-class field (phone, website, hours, address, geocode, services, etc.), verification mix (partner_verified vs verified vs unverified), 30/90/180/365-day freshness distribution, top 20 data sources, deduplication stats, methodology pointer. 30-min cache."}},"/api/feed/news.atom":{"get":{"summary":"Combined Atom firehose: press releases + active FEMA disaster declarations + platform milestones. Subscribers: journalists, RSS aggregators, content-monitoring services, AI clients. 30-min cache. CC BY 4.0."}},"/changelog":{"get":{"summary":"Public platform-updates timeline with NewsArticle JSON-LD per entry. For donors / journalists / partners / AI agents tracking what is new at Feed America."}},"/sponsors":{"get":{"summary":"Corporate giving + matching-gift program landing for CSR officers + ERG leaders. Lists 8+ matching-gift platforms (Benevity, YourCause, etc.) where Feed America is searchable by EIN, plus 4-tier sponsorship pyramid ($25K-$250K+)."}},"/story-pitches":{"get":{"summary":"10 ready-to-write hunger journalism story angles with hooks, citation URLs, suggested experts, follow-up sources. Each angle has a stable anchor URL."}},"/calendar":{"get":{"summary":"Federal food-assistance program calendar with 12 Event JSON-LD entries (SNAP issuance, school year, SFSP, WIC recert, TEFAP, CSFP, FMNP/SFMNP, D-SNAP, IRS deadline, SNAP COLA, WIC food list)."}},"/glossary":{"get":{"summary":"25-term food-assistance acronym dictionary with DefinedTermSet JSON-LD: SNAP, EBT, WIC, TEFAP, CSFP, NSLP, SBP, SFSP, CEP, D-SNAP, FQHC, FNS, FDPIR, FPL, FRAC, HSDS, SDOH, etc."}},"/research":{"get":{"summary":"Academic + journalist data-access landing with Dataset JSON-LD. CC BY 4.0 license; citation guide; 4 dataset distribution formats."}},"/grants":{"get":{"summary":"Foundation officer + program officer landing — grant-ready 501(c)(3) signals, 5 grant programs (unrestricted, state-restricted, D-SNAP, Spanish, partner-verified expansion), DAF/ACH/wire/check workflow, due-diligence packet links, EIN disambiguation. NonprofitOrganization + Service + FAQPage (8 Q&As) JSON-LD."}},"/grants/{state}":{"get":{"summary":"Per-state foundation officer landing. 51 SSR pages targeting \"[state] hunger relief grant nonprofit\" queries. Live D1 state stats, sister-entity reference for TX/FL, state-restricted grant programs with USD ranges. NonprofitOrganization (areaServed=AdministrativeArea) + Service + FAQPage JSON-LD."}},"/es/grants":{"get":{"summary":"Spanish parity for /grants. Targets Spanish-speaking foundation officers, Latin American family offices, US Hispanic-led community foundations. Same Schema.org markup with inLanguage=es-US."}},"/financials":{"get":{"summary":"Donor + journalist financial transparency hub. IRS Form 990 + audited statements + program-spending ratio (≥85%) commitment + reserve policy + Form W-9 + ratings (Candid Platinum, IRS, ProPublica) + EIN disambiguation. NonprofitOrganization + FAQPage (8 Q&As) JSON-LD."}},"/api/v1/financials.json":{"get":{"summary":"Machine-readable financial transparency snapshot. Single JSON endpoint for AI agents and partner accounting systems verifying organizational legitimacy. EIN, IRS status, ratings, public filings, financial commitments, governance, sister entities, homonym disambiguation, granting workflow, contacts. CC BY 4.0. 30-min cache."}},"/api/v1/grants.json":{"get":{"summary":"Machine-readable grants snapshot. Single JSON endpoint for AI agents and grant-discovery aggregators answering \"what grants does Feed America accept and how much should we recommend?\" 5 grant programs with USD ranges, 8 granting methods, sister-entity guidance, homonym disambiguation. CC BY 4.0. 30-min cache."}},"/api/v1/qa-es.json":{"get":{"summary":"Spanish canonical Q&A pairs for AI / chatbot ingestion. 13 Q&As covering org identity, EIN disambiguation, finding food, applying for SNAP/WIC, D-SNAP, donation, legitimacy, claiming pantry listings, founder, languages, active disasters. FAQPage with inLanguage=es-US. 30-min cache."}},"/api/v1/sister-entities.json":{"get":{"summary":"Clean structured data on the 3-entity 501(c)(3) family (parent + 2 sisters) + Chicago homonym warning + 2 similar-named unrelated orgs + 6 decision-guidance paths. 60-min cache."}},"/api/v1/donor-rights.json":{"get":{"summary":"Machine-readable AFP / Giving USA Donor Bill of Rights with Feed America implementation policy for each of the 10 rights + 7 voluntary commitments + concern-filing channels + external oversight list. 60-min cache."}},"/api/v1/press-kit.json":{"get":{"summary":"Machine-readable press kit fact sheet for journalists. 50w/100w/200w boilerplate, 6-category fact sheet, accurate vs. inaccurate phrasings, image assets, press contact + SLA + embargo policy. 30-min cache."}},"/api/v1/programs.json":{"get":{"summary":"Programmatic catalog of 13 Feed America programs categorized by P0/P1/P2 priority. Used by donor-platforms (Giving Tuesday, Benevity, YourCause) and partner aggregators to categorize work. 60-min cache."}},"/api/v1/grants/{state}.json":{"get":{"summary":"Per-state machine-readable grants data (51 endpoints). Mirror of /grants/<state> in JSON for AI agents and grant-discovery aggregators. Live D1 stats, 3 grant programs, sister-entity reference for TX/FL, homonym disambiguation. 30-min cache."}},"/api/v1/es-grants/{state}.json":{"get":{"summary":"Spanish per-state machine-readable grants data (51 endpoints). Mirror of /es/grants/<state> in JSON for Spanish-speaking AI agents and Latin American grant aggregators. 30-min cache."}},"/es/grants/{state}":{"get":{"summary":"Spanish per-state foundation officer landing (51 SSR pages). Mirror of /grants/<state>. inLanguage=es-US."}},"/major-gifts":{"get":{"summary":"Major-gift donor + planned-giving landing for donors $10K+. 9 gift types (cash/ACH/wire, stock, DAF, IRA QCD, bequest, CRT/CLT, retirement-plan beneficiary, multi-year pledge, real property), donor stewardship cycle, tax-treatment summary."}},"/es/major-gifts":{"get":{"summary":"Spanish parity for /major-gifts. inLanguage=es-US."}},"/api/v1/major-gifts.json":{"get":{"summary":"Machine-readable major-gift JSON for wealth-platform AI agents. 9 gift types + stewardship cycle + tax treatment + EIN disambiguation. 60-min cache."}},"/api/v1/major-gifts-es.json":{"get":{"summary":"Spanish parity for /api/v1/major-gifts.json."}},"/family-foundations":{"get":{"summary":"Private family-foundation landing. IRC 4945 qualifying-distribution status, 8 mission-alignment options, multi-foundation co-funding, next-gen board engagement."}},"/es/family-foundations":{"get":{"summary":"Spanish parity for /family-foundations."}},"/api/v1/family-foundations.json":{"get":{"summary":"Machine-readable family-foundation data: IRC 4945/4942 compliance, grant documentation SLAs, 8 mission-alignment options, co-funding patterns, grant agreement review criteria. 60-min cache."}},"/endowment":{"get":{"summary":"Perpetual-giving / endowment landing. UPMIFA-compliant, 4.5% annual draw rate, 60/40 IPS, $100K minimum for donor-named funds, 8 designated-program options."}},"/es/endowment":{"get":{"summary":"Spanish parity for /endowment."}},"/api/v1/endowment.json":{"get":{"summary":"Machine-readable endowment data: UPMIFA governance, 4.5% draw rate methodology, IPS target allocation, designation options, planned-gift instruments, donor reporting tiers, tax treatment, homonym disambiguation. 60-min cache."}},"/api/v1/legacy.json":{"get":{"summary":"Machine-readable bequest + planned-giving data: 6 bequest language templates (English) + 3 (Spanish), 8 planned-gift instruments with legal/tax treatment, Legacy Circle donor recognition, tax treatment summary, homonym disambiguation with probate-court warning. For estate-planning AI agents, will-drafting platforms, planned-giving advisor tools. 60-min cache."}},"/api/v1/ratings.json":{"get":{"summary":"Machine-readable charity watchdog ratings + verification signals. 6 third-party raters (Candid, IRS, ProPublica, Charity Navigator, BBB Wise Giving, CharityWatch) + 7 voluntary commitments + 9 governance signals + homonym disambiguation. For donor-recommendation AI agents. 60-min cache."}},"/api/v1/ratings-es.json":{"get":{"summary":"Spanish parity for /api/v1/ratings.json."}},"/api/v1/giving-options.json":{"get":{"summary":"Consolidated mega-index of 10 donor archetypes (small individual, recurring monthly, major gift, planned giving, endowment, family foundation, institutional foundation, corporate CSR, matching gift, DAF) with target ranges + entry URLs + machine-readable JSON cross-references. Single-fetch overview for AI agents. 60-min cache."}},"/api/v1/giving-options-es.json":{"get":{"summary":"Spanish parity for /api/v1/giving-options.json."}},"/api/v1/snap-eligibility.json":{"get":{"summary":"FY2026 SNAP eligibility thresholds + benefits + deductions + citizenship requirements + work requirements. For AI agents (Alexa, Google Assistant, ChatGPT) helping users determine SNAP qualification. 24-hour cache."}},"/api/v1/snap-eligibility-es.json":{"get":{"summary":"Spanish parity for /api/v1/snap-eligibility.json."}},"/api/v1/wic-eligibility.json":{"get":{"summary":"WIC categorical + residential + income (≤185% FPL) + nutritional risk eligibility tests, FY2026 income limits, certification periods, citizenship requirements (lower barriers than SNAP). For AI agents helping pregnant/postpartum mothers determine WIC qualification. 24-hour cache."}},"/api/v1/wic-eligibility-es.json":{"get":{"summary":"Spanish parity for /api/v1/wic-eligibility.json."}},"/api/v1/school-meals-eligibility.json":{"get":{"summary":"NSLP + SBP + SFSP eligibility: 4 pathways (free / reduced-price / paid / CEP universal-free), FY2026 income thresholds, 6+ categorical eligibility paths (SNAP/TANF/FDPIR/Medicaid/foster/homeless/migrant/Head Start), 10 universal-free state list, application process. 24-hour cache."}},"/api/v1/school-meals-eligibility-es.json":{"get":{"summary":"Spanish parity for /api/v1/school-meals-eligibility.json."}},"/api/v1/eligibility-summary.json":{"get":{"summary":"Consolidated mega-overview of all 9 federal food-assistance programs (SNAP, WIC, NSLP/SBP, SFSP, TEFAP, CSFP, D-SNAP, FDPIR, FMNP/SFMNP) with quick-eligibility decision tree (6 steps) + immigration-status guidance + cross-references to per-program eligibility JSON. Single-fetch overview for AI agents triaging \"do I qualify\" queries. 24-hour cache."}},"/api/v1/eligibility-summary-es.json":{"get":{"summary":"Spanish parity for /api/v1/eligibility-summary.json."}},"/api/v1/states.json":{"get":{"summary":"Master state index — all 51 states/territories with per-state landing URLs (atlas, grants, apply-snap, apply-wic, food-pantry, disasters, press, food-help, all in EN + ES where applicable) + machine-readable JSON cross-references + universal-free-meals state list + sister-entity note for TX/FL. Live D1 location count per state. 60-min cache."}},"/api/v1/states-es.json":{"get":{"summary":"Spanish parity for /api/v1/states.json."}},"/api/v1/help-near-me.json":{"get":{"summary":"Emergency-help routing: same-day food channels (211, SMS 211, directory open-now filter, USDA SFSP SMS), federal program phone numbers, by-situation decision tree (6 situations). For AI agents answering \"I am hungry now\" queries. 60-min cache."}},"/api/v1/help-near-me-es.json":{"get":{"summary":"Spanish parity for /api/v1/help-near-me.json."}},"/api/v1/cities.json":{"get":{"summary":"Top US cities by food-assistance location count (≥20 locations). Up to 200 cities with directory search URLs + per-city food-pantry index URLs. Live D1 GROUP BY query. 60-min cache."}},"/api/v1/quick-stats.json":{"get":{"summary":"At-a-glance organizational stats: total verified locations, food resources vs SNAP retailers, partner-verified pantries, states + cities covered, coverage summary, discovery endpoint cross-references. 10-min cache."}},"/api/v1/program-deadlines.json":{"get":{"summary":"Upcoming federal-program deadlines (IRS Dec 31, IRS Apr 15 filing, SNAP COLA Oct 1, school year start, SFSP summer season, FMNP/SFMNP farmers market season, Giving Tuesday). 24-hour cache."}},"/api/v1/program-deadlines-es.json":{"get":{"summary":"Spanish parity for /api/v1/program-deadlines.json."}},"/api/v1/commodity-programs.json":{"get":{"summary":"TEFAP + CSFP + FDPIR commodity-distribution programs (separate from SNAP/WIC benefit programs). Eligibility, delivery format, geographic coverage, common pantry-pathway. AI agents helping users navigate the food-assistance landscape often miss these. 24-hour cache."}},"/api/v1/commodity-programs-es.json":{"get":{"summary":"Spanish parity for /api/v1/commodity-programs.json."}},"/api/v1/data-sources.json":{"get":{"summary":"Meta-endpoint cataloging all data sources Feed America ingests from. Tier 3 (federal primary): USDA FNS / HRSA / NCES / state WIC / OpenFEMA / IRS. Tier 2 (curated nonprofit): Plentiful, Salvation Army, AmpleHarvest, FoodPantries.org, 211, LA Regional Food Bank. Tier 1 (community-contributed): /submit, /pantry, \"helpful\" feedback. Plus refresh cadence + license + verification methodology. For academic researchers + journalists fact-checking. 24-hour cache."}},"/api/v1/integrations.json":{"get":{"summary":"Partner integration catalog: 6 protocols (HSDS 3.0, OpenAPI, MCP, AI plugin, SMS webhook, embed widget) + 14 use-case integration paths across healthcare SDOH (4), education (2), AI assistants (4), nonprofit partner (2). For platform vendors evaluating Feed America integration. 24-hour cache."}},"/api/v1/changelog.json":{"get":{"summary":"Machine-readable changelog mirror of /changelog HTML. Latest 10 major surface additions in reverse-chrono order with title + detail + URL. AI agents iterate this periodically to discover newly-shipped endpoints. 60-min cache."}},"/api/v1/safety-net.json":{"get":{"summary":"Broader safety-net mapping. Food-insecure users often need adjacent help (housing HUD/Section 8, utilities LIHEAP, healthcare Medicaid/FQHC, childcare CCDF/Head Start, cash TANF/SSI/EITC, workforce WIOA, tax prep VITA). 8 pillars + co-occurrence patterns + 211 universal routing. We route to authoritative federal sources only — we operate food only. 24-hour cache."}},"/api/v1/safety-net-es.json":{"get":{"summary":"Spanish parity for /api/v1/safety-net.json."}},"/api/v1/whoami.json":{"get":{"summary":"Self-describing elevator pitch with explicit scope boundaries. Single-fetch canonical answer to \"who is Feed America?\" with what we ARE (7 statements) + what we are NOT (10 statements with sister/homonym disambiguation), 10 primary audiences, 7 key differentiators, 6 canonical facts for AI agents, 5 inaccurate phrasings to avoid. The shortest path to a correct first-mention. 60-min cache."}},"/api/v1/whoami-es.json":{"get":{"summary":"Spanish parity for /api/v1/whoami.json."}},"/.well-known/whoami.json":{"get":{"summary":"Well-known path alias for /api/v1/whoami.json (per RFC 8615 well-known URI scheme). AI agents probing well-known paths first find Feed America identity at canonical location."}},"/.well-known/openapi.json":{"get":{"summary":"RFC 8615 well-known path alias for /api/openapi.json. AI agents probing well-known paths for service discovery find Feed America full API surface here."}},"/.well-known/llms.txt":{"get":{"summary":"RFC 8615 well-known path alias for /llms.txt. AI crawlers probing well-known paths find Feed America LLM-friendly summary here."}},"/.well-known/donate.json":{"get":{"summary":"RFC 8615 well-known path alias for /donate.json. AI agents asking \"where can I donate to Feed America?\" find the canonical donation metadata here."}},"/.well-known/contact.json":{"get":{"summary":"RFC 8615 well-known path alias for /api/v1/contacts.json. AI agents asking \"how do I contact Feed America?\" find the 12-channel contact directory here."}},"/.well-known/ai-plugin.json":{"get":{"summary":"AI plugin manifest (legacy ChatGPT plugins). Discovery for OpenAI plugin store + ChatGPT-compatible AI clients."}},"/.well-known/mcp.json":{"get":{"summary":"Anthropic MCP (Model Context Protocol) discovery manifest. Lets Claude Desktop, Claude API tool-use, Cursor IDE, and other Anthropic-compatible AI clients discover Feed America\\u0027s MCP server with 7 tools."}},"/snap-benefits-2026":{"get":{"summary":"FY2026 (Oct 2025 - Sept 2026) SNAP benefit amounts: max benefit by household size ($295-$1,772), gross income limits 130% FPL, calculation walkthrough, COLA effective date. SEO landing for \"snap benefits 2026\" + \"food stamps amount 2026\" + \"how much food stamps 2026\" search queries."}},"/es/snap-benefits-2026":{"get":{"summary":"Spanish parity for /snap-benefits-2026."}},"/wic-income-limits-2026":{"get":{"summary":"FY2026 WIC income limits at 185% FPL with categorical eligibility (5 categories), adjunctive eligibility (SNAP/TANF/Medicaid), 4-test framework. SEO landing for \"wic income limits 2026\" + \"wic eligibility 2026\" queries."}},"/es/wic-income-limits-2026":{"get":{"summary":"Spanish parity for /wic-income-limits-2026."}},"/2026-food-assistance-changes":{"get":{"summary":"Year-current \"what\\u0027s new in food assistance 2026\" SEO landing covering FY2026 SNAP COLA + WIC + school meals + IRA QCD limit changes."}},"/es/2026-food-assistance-changes":{"get":{"summary":"Spanish parity for /2026-food-assistance-changes."}},"/free-grocery-near-me":{"get":{"summary":"Synonym-target SEO landing for \"free grocery near me\" / \"free groceries near me\" queries that don\\u0027t match the food-pantry vocabulary. ZIP search redirect + 5 venue-type explainer + emergency 211 routing."}},"/es/free-grocery-near-me":{"get":{"summary":"Spanish parity for /free-grocery-near-me."}},"/emergency-food-assistance":{"get":{"summary":"Urgency-targeting SEO landing for \"emergency food assistance\" queries. 5 paths to get food in <24 hours: 211, pantries open now, D-SNAP, SFSP summer meals, TEFAP at local pantries."}},"/es/emergency-food-assistance":{"get":{"summary":"Spanish parity for /emergency-food-assistance."}},"/food-stamps-application-step-by-step":{"get":{"summary":"Step-by-step SNAP application guide. 7 steps: verify eligibility, gather documents, find state portal, submit (online/in-person/mail), interview, wait, receive EBT. SEO landing for \"how to apply for snap step by step\" query."}},"/es/food-stamps-application-step-by-step":{"get":{"summary":"Spanish parity for /food-stamps-application-step-by-step."}},"/how-much-food-stamps-will-i-get-2026":{"get":{"summary":"Calculator-style SEO landing for \"how much food stamps will I get\" query. Formula explanation + 6 deductions + 3 worked examples (single mom, no income, senior with SS+rent)."}},"/es/how-much-food-stamps-will-i-get-2026":{"get":{"summary":"Spanish parity."}},"/what-can-i-buy-with-snap-ebt":{"get":{"summary":"SEO landing for \"what can I buy with food stamps\" query. 7 eligible food categories + 6 ineligible items + Restaurant Meals Program states + online SNAP purchasing + EBT balance lookup."}},"/es/what-can-i-buy-with-snap-ebt":{"get":{"summary":"Spanish parity."}},"/how-to-find-food-pantry":{"get":{"summary":"5-path SEO landing for \"how to find a food pantry\" query: directory, 211 + SMS, Google Maps, state agency, school/community pantry. Plus 5 venue types."}},"/es/how-to-find-food-pantry":{"get":{"summary":"Spanish parity."}},"/food-help-for-veterans":{"get":{"summary":"Veteran-targeted SEO landing. 7 resource categories: VA wellness lines (988+1), SNAP for vets, VFW/Legion/DAV/VVA pantries, Stand Down events, MAZON Veterans Initiative, VFW Buddy Bag, SSVF/HUD-VASH."}},"/es/food-help-for-veterans":{"get":{"summary":"Spanish parity."}},"/food-help-for-college-students":{"get":{"summary":"College-student-targeted SEO landing. CUFBA campus pantries, SNAP 8-exception eligibility (20+ hrs/week, work-study, disability, parent of <6, etc.), Swipe Out Hunger app, state Hunger-Free Campus initiatives."}},"/es/food-help-for-college-students":{"get":{"summary":"Spanish parity."}},"/corporate-giving":{"get":{"summary":"Fortune 500 CSR officer landing. 4 partnership structures (multi-year unrestricted, programmatic, disaster-response capacity grant, employee engagement integration), ESG/SDG alignment, brand-safety provisions, EIN disambiguation for procurement systems."}},"/es/corporate-giving":{"get":{"summary":"Spanish parity for /corporate-giving."}},"/api/v1/corporate-giving.json":{"get":{"summary":"Machine-readable corporate giving data: 4 partnership structures, ESG/SDG alignment, 7 trust signals, corporate-grade reporting tiers, brand-safety provisions, homonym disambiguation. For corporate-procurement intake systems + CSR-decision AI agents. 60-min cache."}},"/api/v1/calendar.json":{"get":{"summary":"Machine-readable federal food-assistance calendar (12 events: SNAP issuance, school year, SFSP, WIC recert, TEFAP, CSFP, FMNP/SFMNP, D-SNAP, IRS deadline, SNAP COLA, WIC food list). For AI agents and 211 dispatch routing systems answering \"when does X start\". 60-min cache."}},"/api/v1/calendar-es.json":{"get":{"summary":"Spanish parity for /api/v1/calendar.json."}},"/api/v1/glossary.json":{"get":{"summary":"25-term food-assistance acronym dictionary (SNAP, EBT, WIC, TEFAP, CSFP, NSLP, SBP, SFSP, CEP, D-SNAP, FQHC, FNS, FDPIR, FPL, FRAC, HSDS, SDOH, HRSA, NCES, IRS, 501(c)(3), EIN, DAF, QCD, RMD) for AI agents expanding acronyms in conversational responses. 60-min cache."}},"/api/v1/glossary-es.json":{"get":{"summary":"Spanish parity for /api/v1/glossary.json."}},"/api/v1/contacts.json":{"get":{"summary":"Comprehensive contact directory: 12 email channels with purpose + SLA, 9 web channels, 20-path inquiry-routing table mapping donor situations to recommended channel. 60-min cache."}},"/api/v1/founder.json":{"get":{"summary":"Machine-readable founder bio (Sharika Parkes) for Wikipedia editors, journalist AI agents, biographical reference services. Person Schema.org markup ready to paste. 60-min cache."}},"/policies":{"get":{"summary":"Comprehensive policy hub: 11 governance + donor-protection policies (bylaws, COI, whistleblower, document retention, executive compensation, reserves, gift acceptance, donor privacy, anti-discrimination, child safety, data license)."}},"/api/v1/policies.json":{"get":{"summary":"Machine-readable policies catalog. 13 documented policies with public_reference (Form 990 line / Schedule / public URL) per entry. Used by Charity Navigator, Candid crawlers, BBB Wise Giving Alliance ingest. 60-min cache."}},"/api/v1/comparison.json":{"get":{"summary":"Side-by-side disambiguation matrix between Feed America (us, EIN 92-1761881) and the larger Chicago-based homonym (EIN 36-3673599 — separate organization). 13-field comparison + 5-step avoidance checklist + statements about what we don't imply about the homonym. 60-min cache."}},"/board":{"get":{"summary":"Board governance disclosure: 5 standing committees (Audit, Governance, Compensation, Finance, Programs), term limits (3yr × 3 = 9yr cap), meeting cadence, COI procedure, whistleblower channel, Form 990 disclosure map."}},"/api/v1/board.json":{"get":{"summary":"Machine-readable board governance for Charity Navigator + Candid governance crawlers. 5 standing committees with scope, term limits, COI procedure, whistleblower channel, 8-row Form 990 disclosure map. 60-min cache."}},"/api/v1/donor-rights-es.json":{"get":{"summary":"Spanish parity for /api/v1/donor-rights.json. AFP Donor Bill of Rights translated with Feed America implementation policy."}},"/api/v1/policies-es.json":{"get":{"summary":"Spanish parity for /api/v1/policies.json. 13 documented policies with public_reference per entry."}},"/api/v1/board-es.json":{"get":{"summary":"Spanish parity for /api/v1/board.json. Board governance for Spanish-language watchdog crawlers."}},"/api/v1/sister-entities-es.json":{"get":{"summary":"Spanish parity for /api/v1/sister-entities.json. 3-entity 501(c)(3) family + Chicago homonym warning + decision-guidance paths."}},"/api/v1/contacts-es.json":{"get":{"summary":"Spanish parity for /api/v1/contacts.json. 12-channel contact directory + 11-path inquiry-routing table."}},"/api/v1/founder-es.json":{"get":{"summary":"Spanish parity for /api/v1/founder.json. Sharika Parkes machine-readable bio."}},"/api/v1/programs-es.json":{"get":{"summary":"Spanish parity for /api/v1/programs.json. 7-program catalog by P0/P1 priority."}},"/api/v1/press-kit-es.json":{"get":{"summary":"Spanish parity for /api/v1/press-kit.json. Spanish journalist fact sheet (50w + 200w boilerplate)."}},"/es/board":{"get":{"summary":"Spanish parity for /board. Board governance disclosure with 5 committees, term limits, COI procedure."}},"/why-feed-america":{"get":{"summary":"Donor-conversion editorial. Targets \"why donate to feed america\"  search intent. EIN disambiguation, trust signals, what we don't do, giving channels, avoidance checklist."}},"/es/why-feed-america":{"get":{"summary":"Spanish parity for /why-feed-america. inLanguage=es-US."}},"/es/grant-writers-toolkit":{"get":{"summary":"Spanish parity for /grant-writers-toolkit. inLanguage=es-US."}},"/es/policies":{"get":{"summary":"Spanish parity for /policies. inLanguage=es-US."}},"/grant-writers-toolkit":{"get":{"summary":"Practical resources for grant writers preparing applications naming Feed America as recipient. About-the-grantee paragraphs, mission, problem statement, theory of change, sample objectives + outcomes, logic model, sample budget, sample LOI. CC BY 4.0."}},"/donor-rights":{"get":{"summary":"AFP Donor Bill of Rights — 10-right framework with Feed America implementation policy for each. Standard transparency surface for watchdog orgs and major-gift donors."}},"/es/donor-rights":{"get":{"summary":"Spanish parity for /donor-rights. inLanguage=es-US."}},"/es/financials":{"get":{"summary":"Spanish parity for /financials. inLanguage=es-US."}},"/feeds":{"get":{"summary":"Consolidated subscription landing — 13 subscribable feeds catalogued in 5 sections (news firehose, statistical snapshots, org metadata, open data, AI/LLM discovery)."}},"/atlas/{state}":{"get":{"summary":"Per-state Hunger Atlas HTML page with state-by-state stats, top cities by pantry count, federal program context links, citation block. Dataset + BreadcrumbList JSON-LD."}},"/press/{state}":{"get":{"summary":"Per-state press release in journalism format (FOR IMMEDIATE RELEASE / dateline / headline / lede / Sharika Parkes pull-quote / About boilerplate / press contact). NewsArticle JSON-LD."}},"/disasters/{state}":{"get":{"summary":"Per-state FEMA disaster surfacing with active declarations, D-SNAP eligibility, nearest food assistance. Refreshes from active_disasters table (OpenFEMA-sourced, 6h sync)."}},"/embed/catalog":{"get":{"summary":"Embed catalog HTML page — 9 embeddable Feed America surfaces grouped by audience."}},"/embed/pantry/{id}":{"get":{"summary":"Per-pantry live-status iframe widget. Compact 420×380 card with hours_status badge, address, phone, [Get directions] + [Full details] CTAs. CSP frame-ancestors *. postMessage auto-resize. ?theme=dark for dark mode."}},"/partner/leaderboard":{"get":{"summary":"Public partner-verified pantry leaderboard ranked by state. ItemList JSON-LD with top-20."}},"/badges":{"get":{"summary":"Verified Badge program info page."}},"/badge/{id}.svg":{"get":{"summary":"Per-resource Verified Badge SVG (240×60). \"VERIFIED ON\" if partner_verified, \"LISTED ON\" otherwise. CORS-open for cross-origin embed."}},"/badge/{id}":{"get":{"summary":"Per-resource Verified Badge embed-code landing page with copy-paste HTML snippet."}},"/og/resource/{id}":{"get":{"summary":"Per-resource Open Graph card SVG (1200×630). Used as og:image / twitter:image on /resource/{id} pages."}},"/og/atlas/{state}":{"get":{"summary":"Per-state hunger atlas OG card SVG (1200×630). \"FEED AMERICA · ATLAS · <STATE>\" kicker."}},"/og/press/{state}":{"get":{"summary":"Per-state press-release OG card SVG (1200×630). \"FEED AMERICA · PRESS RELEASE · <STATE>\" kicker."}},"/es/atlas":{"get":{"summary":"Spanish Hunger Atlas national hub. Same Dataset JSON-LD as English /atlas with inLanguage=es-US."}},"/es/atlas/{state}":{"get":{"summary":"Spanish per-state hunger atlas. Reciprocal hreflang chain with /atlas/{state}."}},"/es/glossary":{"get":{"summary":"Spanish 25-term food-assistance acronym dictionary. DefinedTermSet with inLanguage=es-US."}},"/es/calendar":{"get":{"summary":"Spanish federal food-assistance program calendar. 12 Event entries with inLanguage=es-US."}},"/es/disasters/{state}":{"get":{"summary":"Spanish per-state FEMA disaster surfacing. GovernmentService JSON-LD with inLanguage=es-US."}}}}