Inquiry Submission API

Contents

1. Authentication
2. POST — Submit an Inquiry
3. GET — Case Types Public
4. GET — Your Submissions
5. GET — Submission Statistics
6. Case Type Reference
7. Integration: Embed Widget
8. Integration: Custom HTML Form
9. Error Codes

1. Authentication

All API requests except the public case types endpoint require your API key in the X-Api-Key header.

X-Api-Key: YOUR_API_KEY

Your API key is available on your Settings page after registration. Browser-based requests also require your whitelisted domains to be registered there, and requests from unregistered origins will be rejected.

If your CRM, posting engine, or backend can send a custom X-Api-Key header, it can post directly to this API. If it cannot send custom headers, use one of the server-side starter files or the WordPress plugin instead.

Submit a new prospective client inquiry. This endpoint accepts JSON, XML, form-urlencoded, and multipart form data.

Supported Content Types

• application/json
• application/xml or text/xml
• application/x-www-form-urlencoded
• multipart/form-data

JSON Example

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "555-123-4567",
  "caseTypeId": 1,
  "message": "I was in a car accident...",
  "sourceType": 3,
  "sourceUrl": "https://yoursite.com/auto-accident"
}

XML Example

<Lead>
  <Name>John Doe</Name>
  <Email>john@example.com</Email>
  <Phone>555-123-4567</Phone>
  <CaseTypeId>1</CaseTypeId>
  <Message>I was in a car accident...</Message>
  <SourceType>3</SourceType>
  <SourceUrl>https://yoursite.com/auto-accident</SourceUrl>
</Lead>

Source Type Values

Response (201 Created)

{
  "leadId": 42,
  "status": "Pending"
}

cURL Example (JSON)

curl -X POST https://affiliate.dipetrillolaw.com/api/leads \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "555-123-4567",
    "caseTypeId": 1,
    "message": "I need legal representation.",
    "sourceType": 3,
    "sourceUrl": "https://yoursite.com/contact"
  }'

JavaScript (fetch)

fetch("https://affiliate.dipetrillolaw.com/api/leads", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "John Doe",
    email: "john@example.com",
    phone: "555-123-4567",
    caseTypeId: 1,
    message: "I need legal representation.",
    sourceType: 3,
    sourceUrl: window.location.href
  })
})
.then(r => r.json())
.then(data => console.log("Submitted:", data))
.catch(err => console.error("Error:", err));

Returns all active case types. Use this to populate dropdowns in your forms or widget.

[
  { "id": 1, "name": "Auto Accident", "practiceArea": 0 },
  { "id": 2, "name": "Truck Accident", "practiceArea": 0 },
  ...
]

Retrieve all inquiries you have submitted.

[
  {
    "id": 42,
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "555-123-4567",
    "message": "I was in a car accident...",
    "caseType": "Auto Accident",
    "status": "Pending",
    "createdTime": "2026-03-10T12:00:00Z",
    "sourceType": "AffiliateAPI",
    "sourceUrl": "https://yoursite.com/auto-accident"
  }
]

Retrieve summary statistics for your submissions.

{
  "total": 15,
  "pending": 3,
  "accepted": 10,
  "rejected": 2
}

6. Case Type Reference

Use these IDs for the caseTypeId field when submitting inquiries.

7. Integration: Embed Widget

The fastest path to a working intake form. Copy this snippet into any page on your website. The widget renders a styled form, fetches case types automatically, and submits inquiries to the API.

<div id="dp-lead-widget"></div>
<script
  src="https://affiliate.dipetrillolaw.com/js/embed-widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="https://affiliate.dipetrillolaw.com">
</script>

Want to customize the widget's colors and appearance? Use the Widget Configurator to preview themes and generate a ready-to-use snippet.

8. Integration: Custom HTML Form

For full control over styling, use this HTML form template. Copy it, style it to match your site, and the included JavaScript handles submission.

<form id="dpl-custom-form">
  <input type="text" name="name" placeholder="Full Name" required />
  <input type="email" name="email" placeholder="Email" required />
  <input type="tel" name="phone" placeholder="Phone" required />
  <select name="caseTypeId" id="dpl-casetypes" required>
    <option value="">Select Case Type</option>
  </select>
  <textarea name="message" placeholder="Describe your situation" required></textarea>
  <button type="submit">Get Free Consultation</button>
  <div id="dpl-result"></div>
</form>
<script>
(function() {
  var API = "https://affiliate.dipetrillolaw.com";
  var KEY = "YOUR_API_KEY";
  // See full template in Downloads section
})();
</script>

9. Error Codes