Skip to main content
GET /api/v2/storefront/agents Returns the partner agents registered to this storefront as compact summary rows, each with capability metadata and a per-agent account count. Filter by agent type, status, relationship, name, or supportsRegistration, and page with limit and offset. Use Get agent for the full resource.

​
Request

curl "https://api.interchange.io/api/v2/storefront/agents?type=SALES&status=ACTIVE&limit=10" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

ParamTypeRequiredNotes
typeenumNoFilter by agent type: SALES, SIGNAL, CREATIVE, or OUTCOME
statusenumNoFilter by status: PENDING, ACTIVE, or DISABLED
relationshipenumNoSELF = owned by you; MARKETPLACE = all other marketplace agents
namestringNoPartial, case-insensitive match on agent name
supportsRegistrationenumNo"true" returns only agents that require operator authentication; "false" the rest
limitintegerNoPage size (default 20, max 100)
offsetintegerNoRows to skip (default 0)

​
Response

{
  "items": [
    {
      "agentId": "agt_premium_ctv",
      "type": "SALES",
      "name": "Premium CTV — Direct",
      "protocol": "MCP",
      "status": "ACTIVE",
      "relationship": "SELF",
      "requiresOperatorAuth": true,
      "requiresAccount": false,
      "authConfigured": true,
      "createdAt": "2026-05-01T12:00:00Z",
      "customerAccountCount": 2
    }
  ],
  "total": 1,
  "hasMore": false,
  "nextOffset": null
}
status is PENDING, ACTIVE, or DISABLED, plus COMING_SOON for PENDING agents you don’t own. customerAccountCount is your own account count on the agent and replaces the embedded accounts array. When hasMore is true, pass nextOffset back as offset to walk pages.

​
Errors

  • 400 VALIDATION_ERROR — invalid type, status, or relationship value, or out-of-range limit/offset.
See Errors for the full error contract.

Agent tasks

All agent operations

Get agent

Full detail for one agent

Start agent OAuth

Authorize an OAuth agent

Agents overview

Agent types and OAuth concepts