Service-Provider Routing Recommendation

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

Param	Type	Default	Notes
`archetype`	enum	(all)	`stord` \| `flexport` \| `shipbob` \| `generic`
`limit`	int	`10`	Clamped to `[1, 50]`

Ranking

successfulIngestionCount desc — proven track record first
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
    }
  ]
}

Lender Routing Recommendation — same pattern for lenders
MCP tool: recommend_service_provider (wraps this endpoint)

Brand attestation request Merchant Credit-Tier Upgrade Preview

Overview

Admin API

Public API

Trust Fabric API

EAS Schemas (Trust Fabric)

Merchant API

AI Endpoints

Merchant

Customer

Shop

Product

Collection

SKU

Shipping

Gift Card

Blog

Cart

Order

Address Book

Service-Provider Routing Recommendation

Query parameters

Ranking

Example

​Query parameters

​Ranking

​Example

​Related

Query parameters

Ranking

Example

Related