Divorce Network Pro — Developer Documentation

Integrate with the Divorce Network Pro directory using our public REST API, OpenAPI specification, and Model Context Protocol (MCP) server. Search verified divorce professionals — attorneys, mediators, Certified Divorce Financial Analysts (CDFAs), therapists, coaches, parenting coordinators, and 30+ other categories — by location and specialty.

Quick start

# Health check
curl https://divorcenetworkpro.com/api/v1/health

# List professional types
curl https://divorcenetworkpro.com/api/v1/professional-types

# Search attorneys in California
curl "https://divorcenetworkpro.com/api/v1/professionals?state=ca&type=attorney&limit=5"

Resources

OpenAPI specification — machine-readable API surface
llms.txt — agent instructions and when-to-use guidance
MCP manifest — Model Context Protocol tools
OAuth protected resource metadata — RFC 9728 scope discovery
Agent skills index — when-to-use guidance for agents

Public endpoints

These endpoints require no authentication:

GET /api/v1/health — API health check
GET /api/v1/professional-types — List profession categories
GET /api/v1/professionals — Search the directory
POST /api/contact — Contact support

Authentication

Public directory endpoints are open. Authenticated endpoints (professional portal, client portal) use Firebase ID tokens via Authorization: Bearer <token>, obtained through the Firebase client SDK or /api/auth/sessionLogin.

OAuth scopes

Scoped permissions are declared in our protected resource metadata and OpenAPI securitySchemes:

professionals:read — Search and read public professional directory listings
professionals:write — Create and update your professional profile (requires professional account)
services:read — Read marketplace services for a professional
services:write — Manage your marketplace services (requires professional account)
client:read — Read your client portal data (requires client account)
client:write — Update your client portal profile and preferences (requires client account)

Rate limits

Public endpoints allow 60 requests per minute per client. Every response carries RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy headers so agents can self-throttle; exceeding the limit returns a 429 with a Retry-After header and a structured JSON error body.

Versioning & deprecation

The Divorce Network Pro API is versioned in the URL path (/api/v1). Breaking changes ship as a new version — existing versions keep working. When a version is scheduled for retirement, we announce it at least 90 days ahead: responses gain Deprecation and Sunset headers, and the timeline is documented on this page. Nothing is removed without that notice.

MCP server

Connect via Streamable HTTP at https://divorcenetworkpro.com/api/mcp. Tools: search_professionals, list_professional_types. See the MCP manifest for details.

Support

Questions about the API? Email support@divorcenetworkpro.com or use the contact form.