# FirmLedger API

**Canonical:** https://apis.io/apis/firmledger-co-ke/firmledger-co-ke-api/  
**Provider:** FirmLedger — https://apis.io/providers/firmledger-co-ke/  
**Base URL:** https://mcp.firmledger.co.ke  
**Documentation:** https://firmledger.co.ke/api

FirmLedger API is one of 2 APIs that [FirmLedger](https://apis.io/providers/firmledger-co-ke/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

FirmLedger API as documented publicly: 36 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

## Operations (36)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/oauth-authorization-server` | Authorization-server metadata GET https://mcp.firmledger.co.ke/.well-known/oauth-authorization-server (RFC 8414) |
| GET | `/.well-known/oauth-protected-resource/mcp` | Protected-resource metadata GET https://mcp.firmledger.co.ke/.well-known/oauth-protected-resource/mcp (RFC 9728) |
| GET | `/api/v1` | Discovery — versions, endpoints, limits |
| GET | `/api/v1/categories` | Category list with live listing counts |
| GET | `/api/v1/countries` | Countries present in the approved ledger |
| GET | `/api/v1/directory` | Browse FirmLedger's public, approved listings (legacy alias). |
| GET | `/api/v1/directory/{slug}` | Fetch a single approved listing by its slug (legacy alias). |
| GET | `/api/v1/export/listings.csv` | Bulk CSV export of the approved ledger |
| GET | `/api/v1/health` | Liveness probe — authenticated, returns 200 when the API is up |
| GET | `/api/v1/listings` | GET /api/v1/listings |
| POST | `/api/v1/listings` | POST /api/v1/listings — create |
| GET | `/api/v1/listings/{slug}` | Full company profile by slug |
| GET | `/api/v1/me` | Your account, scopes, key usage and live limits |
| GET | `/api/v1/my/listings` | Your listings, paginated (status filter) |
| POST | `/api/v1/my/listings` | Create a listing — enters moderation as pending |
| DELETE | `/api/v1/my/listings/{id}` | Remove your listing and its attachments |
| PUT | `/api/v1/my/listings/{id}` | Update any writable fields on your listing |
| GET | `/api/v1/suggest` | Autocomplete — listings, categories, countries, cities |
| GET | `/api/v1/usage` | Monthly totals, endpoint rankings and trailing 31‑day usage series |
| POST | `/api/v1/usage` | POST /api/v1/usage |
| GET | `/api/v1/verify/domain/{domain}` | Check whether a domain is listed |
| GET | `/api/v1/webhooks` | List your signed event subscriptions |
| POST | `/api/v1/webhooks` | Register a receiver URL and event/category filters |
| GET | `/api/v1/webhooks/7/deliveries` | manage curl https://firmledger.co.ke/api/v1/webhooks/7/deliveries |
| POST | `/api/v1/webhooks/7/rotate-secret` | POST /api/v1/webhooks/7/rotate-secret |
| POST | `/api/v1/webhooks/7/test` | POST /api/v1/webhooks/7/test |
| DELETE | `/api/v1/webhooks/{id}` | Remove a receiver and its delivery history |
| PATCH | `/api/v1/webhooks/{id}` | Update filters, URL or pause state |
| GET | `/mcp` | Primary AI connection address: https://mcp.firmledger.co.ke/mcp |
| POST | `/mcp` | POST /mcp |
| POST | `/mcp/fl_live_your_key` | POST https://mcp.firmledger.co.ke/mcp/fl_live_your_key – personal connector URL |
| GET | `/oauth/authorize` | Authorization GET /oauth/authorize on the connector host named by the issuer metadata |
| POST | `/oauth/register` | Client registration POST https://mcp.firmledger.co.ke/oauth/register (RFC 7591), JSON |
| POST | `/oauth/revoke` | Revocation POST https://mcp.firmledger.co.ke/oauth/revoke (RFC 7009) with token |
| POST | `/oauth/token` | Token POST https://mcp.firmledger.co.ke/oauth/token , form or JSON |
| GET | `/sitemap.xml` | public, auto-indexed |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/firmledger-co-ke/openapi/_ae-authored/firmledger-co-ke-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-api-v1-listings-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-api-v1-webhooks7-rotate-secret-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-api-v1-webhooks7-test-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-mcp-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-mcp-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/firmledger-co-ke/json-schema/firmledger-co-ke-post-oauth-register-request-schema.json

## Other FirmLedger APIs (1)

- [FirmLedger MCP API](https://apis.io/apis/firmledger-co-ke/firmledger-mcp-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/firmledger-co-ke/firmledger-co-ke-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/firmledger-co-ke/.