API Reference

The Bynefit Open Data API provides free, public access to curated community resources — covering food, housing, health care, mental health, employment, legal aid, and more. Coverage expands as partner organizations add their directories. Access requires a free API key; there is no rate limit and no cost.

API key required

Every request to /api/resources must include a valid API key. Pass it as a query parameter or as a request header — both are accepted.

GET https://bynli.com/api/resources?key=YOUR_API_KEY

X-API-Key: YOUR_API_KEY

Keys are free. Mint one at Developers → API keys (no team required) or, for team-scoped tokens, at Integrations → API tokens. Each key can optionally be domain-restricted — requests from unlisted origins are rejected with 403.

CORS headers include Access-Control-Allow-Origin: *, so you can call this endpoint directly from a browser or any frontend framework without a proxy.

GET /resources

Returns a paginated list of approved, active community resources.

Category slugs

Use these exact strings as the category query parameter.

Making requests

curl "https://bynli.com/api/resources?key=YOUR_API_KEY&category=food&limit=10"

const API_KEY = 'YOUR_API_KEY';
const res     = await fetch(`https://bynli.com/api/resources?key=${API_KEY}&category=food&limit=10`);
const data    = await res.json();

data.data.forEach(r => {
  console.log(r.byn_id, r.name, r.category);
});

// Paginate
if (data.has_more) {
  // fetch next page with offset += limit
}

import requests

BASE    = "https://bynli.com/api/resources"
API_KEY = "YOUR_API_KEY"

params = {"key": API_KEY, "category": "housing", "limit": 50, "offset": 0}

while True:
    r    = requests.get(BASE, params=params)
    body = r.json()

    for resource in body["data"]:
        print(resource["byn_id"], resource["name"])

    if not body["has_more"]:
        break
    params["offset"] += params["limit"]

$url  = 'https://bynli.com/api/resources?key=YOUR_API_KEY&category=mental&limit=20';
$body = json_decode(file_get_contents($url), true);

foreach ($body['data'] as $r) {
    echo $r['byn_id'] . ' — ' . $r['name'] . "\n";
}

Live explorer

Try the API directly — data is pulled from the live endpoint.

Enter your API key and click "Run request".

Drop-in resource directory

Add a searchable, filterable resource directory to any website with two lines of HTML. The widget is self-contained, Shadow DOM isolated, and works on any page without CSS conflicts.

<!-- 1. Place a container element where you want the widget -->
<div id="bynefit-resources"></div>

<!-- 2. Load the widget script with your API key -->
<script src="https://bynli.com/resources-widget.js"
        data-key="YOUR_API_KEY"></script>

All options are set via data-* attributes on the script tag:

<div id="food-resources"></div>
<script src="https://bynli.com/resources-widget.js"
        data-key="YOUR_API_KEY"
        data-category="food"
        data-theme="dark"
        data-limit="15"
        data-target="food-resources"></script>

Terms of use

This data is provided by Bynefit Inc. under a public-domain-equivalent license. You are free to use, copy, distribute, and build upon it for any purpose — commercial or noncommercial — without restriction.

The data is provided "as is" with no warranty of accuracy or completeness. Bynefit makes reasonable efforts to keep resource information current but cannot guarantee real-time accuracy of operating hours, availability, or contact details.