API Reference & Guides

X-API-Key: dlp_live_abcdef1234567890abcdef1234567890

POST https://api.delphra.com/api/v1/enrich_product
POST https://api.delphra.com/api/v1/shopper/personalized-fit
POST https://api.delphra.com/api/v1/feedback/fit-outcome
POST https://api.delphra.com/api/v1/catalog/assortment-report

curl -X POST "https://api.delphra.com/api/v1/enrich_product" \
  -H "X-API-Key: dlp_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "external_sku_id": "SKU-10293",
    "title": "Ribbed Modal Wrap Midi Dress",
    "brand": "Delphra Studio",
    "description": "True functional wrap dress in breathable modal rib with adjustable tie above the waist.",
    "image_urls": ["https://example.com/images/10293-front.jpg"],
    "fabric_composition": {"modal": 92.0, "elastane": 8.0},
    "stretch_level": "high",
    "waist_rise": "empire",
    "closure_type": "wrap-tie",
    "curation_mode": "bump_friendly_discovery"
  }'

import httpx

API_ENDPOINT = "https://api.delphra.com/api/v1/enrich_product"
API_KEY = "dlp_live_YOUR_KEY_HERE"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
    "external_sku_id": "sku_8741",
    "title": "Smocked Organic Cotton Midi Dress",
    "description": "Elastic smocked bodice with tiered A-line skirt and flexible straps.",
    "image_urls": ["https://images.example.com/sku_8741.jpg"],
    "fabric_composition": {"cotton": 95.0, "elastane": 5.0},
    "stretch_level": "high",
    "curation_mode": "bump_friendly_discovery",
}

with httpx.Client(timeout=30.0) as client:
    response = client.post(API_ENDPOINT, json=payload, headers=headers)

    if response.status_code == 200:
        result = response.json()
        print(f"Include in Maternity Edit: {result['include']} ({result.get('maternity_classification')})")
        print(f"Sizing Advice: {result.get('sizing_recommendation')}")
        print(f"Shopify Metafields: {result.get('shopify_metafields')}")

{
  "compatible_with_shopper": true,
  "current_stage": "Third Trimester",
  "calculated_pregnancy_week": 28,
  "recommended_size_to_buy": "L (Size up 1 from M for Third Trimester)",
  "sizing_action": "size_up_1",
  "wearable_stages_for_shopper": ["First Trimester", "Second Trimester", "Third Trimester", "Postpartum"],
  "nursing_compatible": true,
  "c_section_compatible": true,
  "storefront_badge": "Verified Fit for Third Trimester — Order Size L + Nursing Ready",
  "personalized_fit_explanation": "Based on your current stage (Third Trimester, Week 28), order L (Size up 1 from M for Third Trimester). Supported across: First Trimester, Second Trimester, Third Trimester, Postpartum."
}

curl -X POST "https://api.delphra.com/api/v1/feedback/fit-outcome" \
  -H "X-API-Key: dlp_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "external_sku_id": "SKU-9824",
    "brand": "Atelier Lumière",
    "pre_pregnancy_size": "M",
    "purchased_size": "M",
    "stage_worn": "Third Trimester",
    "outcome": "returned_tight_at_bump",
    "notes": "Wrap overlap felt narrow at 34 weeks in my usual M."
  }'

# Response (200 OK)
{
  "feedback_id": "fbk_9a4c2e81b03f7d12",
  "status": "recorded",
  "external_sku_id": "SKU-9824",
  "stage_worn": "Third Trimester",
  "outcome": "returned_tight_at_bump",
  "deterministic_calibration_signal": "Calibration trigger: shift Third Trimester sizing_recommendation from true_to_pre_pregnancy_size -> size_up_1."
}

{
  "total_skus_evaluated": 420,
  "qualified_skus_count": 64,
  "rejected_skus_count": 356,
  "qualification_rate_pct": 15.2,
  "stage_coverage": {
    "First Trimester": 61,
    "Second Trimester": 58,
    "Third Trimester": 41,
    "Postpartum": 52
  },
  "financial_impact_estimate": {
    "unlocked_maternity_skus": 64,
    "full_pregnancy_to_postpartum_hero_skus": 38,
    "estimated_inventory_value_unlocked_usd": 264000.0,
    "estimated_annual_return_savings_usd": 31680.0,
    "methodology_note": "Calculated deterministically from 64 qualified SKUs × $165.00 AOV × 25 units/SKU, with 12% return reduction from stage-specific sizing guidance."
  },
  "ready_to_launch_section": true,
  "merchandising_recommendations": [
    "Your catalog has strong coverage across all trimesters, postpartum needs, and core apparel categories to launch a dedicated Maternity & Postpartum Edit."
  ]
}