Skip to content

Leads

Read CRM leads captured across the site's inventory.

  • Base URL: /wp-json/dms/v1/
  • All requests require a Bearer API key - see Authentication.

Endpoints

Method Path Capability Purpose
GET leads view_all_leads All leads across every type (paginated, filterable).
GET leads/type/{type_id} view_all_leads Leads for a single type.
GET leads/{lead_id} view_all_leads A single lead.

All lead endpoints require the view_all_leads capability.

GET /leads

A collection of leads across every type. Accepts the standard pagination params and the collection's optional filters.

curl "https://your-site.com/wp-json/dms/v1/leads?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_KEY"

GET /leads/type/{type_id}

The same collection, scoped to a single inventory type.

curl "https://your-site.com/wp-json/dms/v1/leads/type/4" \
  -H "Authorization: Bearer YOUR_KEY"

GET /leads/{lead_id}

A single lead by ID.

curl "https://your-site.com/wp-json/dms/v1/leads/987" \
  -H "Authorization: Bearer YOUR_KEY"

See also