Skip to main content
GET /v2/service-provider-routing/recommend is the InventoryOS counterpart to lender routing — it returns the ordered list of ACTIVE WMS/3PL providers a merchant should route an inventory ingestion / fulfillment task to.
This endpoint is public and read-only. Routes nothing — the actual ingestion path stays gated on ServiceProviderRegistry.isActive + the HMAC webhook guard.

​
Query parameters

ParamTypeDefaultNotes
archetypeenum(all)stord | flexport | shipbob | generic
limitint10Clamped to [1, 50]

​
Ranking

  1. successfulIngestionCount desc — proven track record first
  2. Ties broken by most-recent successful ingestion (lastSuccessfulIngestionAt)

​
Example

curl 'https://apiv3.droplinked.com/v2/service-provider-routing/recommend?archetype=stord&limit=5'

{
  "archetype": "stord",
  "count": 1,
  "recommendations": [
    {
      "providerId": "stord-us-east-1",
      "displayName": "Stor'd US-East",
      "archetype": "stord",
      "successfulIngestionCount": 47,
      "lastSuccessfulIngestionAt": "2026-06-11T14:30:00Z",
      "rank": 1
    }
  ]
}