scriptmonitoring.comdocs
DomainsList domains

List domains

GET /v1/domains returns your registered domains with their team, Script tag or Agentic crawler mode, wildcard and suspension state, page by page.

All plansUpdated

GET /v1/domains lists the domains registered in your organization, or in one team, with a cursor for paging. Pass domain to look up one hostname. Needs the domains:read scope; any domains:* scope can look up a single domain. Organization keys see every team; a team key sees its own team only.

With an organization key, for one team:

curl "https://data.scriptmonitoring.com/v1/domains/?team_id=YOUR_TEAM_ID&limit=50" \
  -H "Authorization: Bearer sm_org_14829305716342_…"

With a team key, which always reads its own team:

curl "https://data.scriptmonitoring.com/v1/domains/?limit=50" \
  -H "Authorization: Bearer sm_team_10937462815530_…"

Which keys work?#

KeyAccepted
Organization key (sm_org_…)Yes: every team in the organization, or one with team_id.
Team key (sm_team_…)Yes: its own team only. A team_id for any other team gets 404 team_not_found.

A missing, mistyped or revoked key, a key whose prefix doesn't match its type, or a key created before the sm_org_ / sm_team_ format gets 401 with this body:

{ "error": "unauthorized", "message": "Missing or invalid bearer token." }

Query parameters#

NameDescription
team_idRestrict to one team. It must belong to the key's organization; with a team key, it can only be the key's own team.
domainExact hostname to look up.
limitPage size, 1 to 100 (default 50).
cursorThe next_cursor from the previous page.

Response#

{
  "data": [
    {
      "id": "...",
      "domain": "shop.example.com",
      "teamId": "14827391650423",
      "managed": true,
      "wildcard": false,
      "suspended": false,
      "createdAt": "..."
    }
  ],
  "next_cursor": null
}

managed is true for a Script tag domain and false for an Agentic crawler domain. Errors: 400, 401, 403, 404 team_not_found, 429, 503.

Questions? Ask in the chat, or in the dashboard.View as Markdown