Integration status report

Report configured merchant integration surfaces and explicit payment capability flags. Direct merchant payment and optional credit purchases are distinct.

GET/v1/integrations

Authorization

AuthorizationBearer token (JWT) · headerrequired

Clerk human owner session JWT; iss must equal the configured Clerk issuer and the identity must be a human (not agent) owner with a verified email.

AuthorizationBearer token (JWT) · headerrequired

Verified AgentID agent JWT (iss https://auth.agentid.com) or an agentsub OAuth access token (typ at+jwt, iss https://api.agentsub.dev, scope agentsub:agent). The agent's human owner must exist in Clerk with the same verified email.

AuthorizationBearer token · headerrequired

Scoped merchant API key (asm_...) issued via POST /v1/merchants/{id}/api-keys. Path/scope-restricted; cannot access human or agent routes.

AuthorizationOAuth2 access token · headerrequired

Scopes:agentsub:owner

Responses

200

Identity providers, merchant access endpoints and payment capability flags. No provider credentials or provider command integrations are exposed.

identityobject

Show properties

agentstring

humanstring

accessCheckobject

Show properties

endpointstring

enabledboolean

merchantRegistryobject

Show properties

endpointstring

enabledboolean

paymentsobject

Show properties

directMerchantLinkobject

Show properties

enabledboolean

optionalCreditPurchasesobject

Show properties

enabledboolean

x402object

Show properties

enabledboolean

401

unauthorized problem; live 401s advertise WWW-Authenticate: Bearer resource_metadata=...

typestringrequired

titlestringrequired

statusintegerrequired

codestringrequired

503

Runtime or provider configuration unavailable (runtime_configuration_required, signing_configuration_required, runtime_unavailable, workspace_unavailable, provider_configuration_required)

typestringrequired

titlestringrequired

statusintegerrequired

codestringrequired

Request

curl -X GET 'https://api.agentsub.dev/v1/integrations' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.agentsub.dev/v1/integrations", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.agentsub.dev/v1/integrations",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "identity": {
    "agent": "AgentID",
    "human": "Clerk"
  },
  "accessCheck": {
    "endpoint": "string",
    "enabled": true
  },
  "merchantRegistry": {
    "endpoint": "string",
    "enabled": true
  },
  "payments": {
    "directMerchantLink": {
      "enabled": true
    },
    "optionalCreditPurchases": {
      "enabled": true
    },
    "x402": {
      "enabled": true
    }
  }
}

{
  "type": "https://agentsub.dev/problems/not_found",
  "title": "string",
  "status": 0,
  "code": "string"
}

{
  "type": "https://agentsub.dev/problems/not_found",
  "title": "string",
  "status": 0,
  "code": "string"
}