Partner API · v1

The Community Identity API

Let your platform display verified community ownership badges for any SmartLogoz-registered business. One registration. Every platform.

Request API Key View Endpoints

For enterprise & procurement teams

This is not a DEI program.

SmartLogoz is verified public business data — the same category as a BBB accreditation, a state license, or a Google rating. Business owners self-declare and self-register their community identity. Your platform simply displays a publicly declared fact.

Owned by the business

The badge belongs to the business that registered it — not to your platform, not to a policy. You're a display layer, not a decision-maker.

Compliance-friendly framing

"We surface publicly verified business identity data from a third-party registry" is a very different sentence than "we have a DEI program."

Immune to internal policy

A corporate memo can remove an internal classification. It cannot remove a verified external data field that a business owner controls.

SmartLogoz does not tell companies who to hire, who to promote, or how to spend their budgets. It is an opt-in public registry. Displaying its data is an act of market transparency, not corporate policy.

How it works

STEP 01

Business registers once

A business registers on SmartLogoz, selects their community codes (Black-owned, Women-owned, Veteran, etc.), and gets a verified SmartLogo badge.

STEP 02

You query our API

Your platform calls our API with the business EIN or name. We return their verified community codes and a ready-to-embed badge.

STEP 03

Display on your platform

Render the badge JSON with your own UI, or drop in a single <img> tag pointing to our SVG badge endpoint. Zero setup required.

Authentication

Pass your API key in the X-SmartLogoz-Key request header on every call.

curl -H "X-SmartLogoz-Key: sl_live_your_key_here" \
  https://smartlogoz-production.up.railway.app/v1/communities

Endpoints

GET/v1/communities

Full list of all 23+ supported community codes with labels and emoji.

Request

curl -H "X-SmartLogoz-Key: YOUR_KEY" \
  https://smartlogoz-production.up.railway.app/v1/communities

Response

{
  "data": [
    { "code": "B",  "group": "heritage", "label": "Black / African American", "emoji": "🏴" },
    { "code": "L",  "group": "heritage", "label": "Latino / Hispanic",        "emoji": "🪅" },
    { "code": "W",  "group": "identity", "label": "Women-Owned",              "emoji": "💜" }
    ...
  ],
  "meta": { "count": 23, "version": "1" }
}

Drop-in Badge Embed + Interactive Widget

Option A — static image, no JS required. Option B — embed.js widget: hover shows community identity card, click opens the SmartLogoz verification page.

<!-- Option B: Interactive widget (no API key needed) -->
<script src="https://smartlogoz.com/embed.js"
  data-business="BUSINESS_ID"
  data-theme="dark">
</script>

Hovering the badge shows business name, community codes, and a "Register your business" CTA. Clicking opens smartlogoz.com/verify/BUSINESS_ID.

HTML

<img
  src="https://smartlogoz-production.up.railway.app/v1/badge/{id}/svg"
  alt="SmartLogoz Verified"
  height="64"
/>

Preview (dark)

SmartLogoz Verified

Peach Street Bakery

🏴 Black-Owned · 💜 Women-Owned

API Plans

$0forever

Free

200 req / 15 min

✓ All read endpoints
✓ Community lookup
✓ Badge embed
✓ Email support

Request Free Key

Ready to integrate?

Email us with your platform name, estimated call volume, and use case. We'll provision your key within 24 hours.

Request API Access

api@smartlogoz.com · Free keys provisioned within 24 hours