Stats
Actions
Tags
From airship
List all channels registered to an app key with pagination support. Channels are returned in sorted order by channel_id (UUID). Use when you need to retrieve multiple channels, export audience data, or perform bulk operations on channels.
How this skill is triggered — by the user, by Claude, or both
Slash command
/airship:channel-listingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
List all channels registered to an app key with pagination support. Channels are returned in sorted order by `channel_id` (UUID), enabling efficient parallel pagination strategies. Tags added via Named Users tag endpoint won't appear - use Named User lookup if needed.
List all channels registered to an app key with pagination support. Channels are returned in sorted order by channel_id (UUID), enabling efficient parallel pagination strategies. Tags added via Named Users tag endpoint won't appear - use Named User lookup if needed.
Method: GET
Path: /api/channels
Base URL:
https://go.urbanairship.comhttps://go.airship.euhttps://api.asnapius.comhttps://api.asnapieu.comPath: /api/channels
| Method | Endpoint | Scope |
|---|---|---|
| OAuth (recommended) | api.asnapius.com | chn |
| Bearer token | go.urbanairship.com | — |
| Basic | go.urbanairship.com | — |
See Authentication Guide for token request details and MCP setup.
OAuth (api.asnapius.com):
Authorization: Bearer <oauth_token>
Accept: application/vnd.urbanairship+json; version=3
Bearer token (go.urbanairship.com):
Authorization: Bearer <dashboard_token>
Accept: application/vnd.urbanairship+json; version=3
Basic (go.urbanairship.com):
Authorization: Basic <base64(app_key:master_secret)>
Accept: application/vnd.urbanairship+json; version=3
limit (integer, optional): Maximum results per request. Default 1,000, maximum 1,000.start (string, optional): channel_id (UUID) to start pagination from. Channels returned in sorted order.Uses cursor-based pagination with start parameter:
start to get first pagechannel_id from last item of previous page as startnext_page URL with start already setKey Insight: UUIDs are evenly distributed across hex digits (0-9, a-f), enabling parallel pagination across 16 threads.
{
"ok": true,
"channels": [
{
"channel_id": "9c36e8c7-5a73-47c0-9716-99fd3d4197d5",
"device_type": "ios",
"installed": true,
"opt_in": true,
"push_address": "FE66489F304DC75B8D6E8200DFF8A456E8DAEACEC428B427E9518741C92C6660",
"created": "2020-08-08T20:41:06",
"last_registration": "2020-10-07T21:28:35",
"named_user_id": "some_id_that_maps_to_your_systems",
"tags": ["tag1", "tag2"],
"tag_groups": {
"tag_group_1": ["tag1", "tag2"]
}
}
],
"next_page": "https://api.asnapius.com/api/channels?limit=1000&start=535ec31e-4b07-4b26-bead-a1c0e94e133c"
// Note: next_page hostname reflects the base URL used for the request (US or EU)
}
channel_id (UUID): Unique identifierdevice_type: ios, android, amazon, web, open, email, smsinstalled, opt_in (boolean): Channel statuspush_address / address: Push notification addressnamed_user_id: Associated named usertags, tag_groups: Tags and tag groupscreated, last_registration: TimestampsSee example files: list-channels-first-page.json, list-channels-paginated.json
GET /api/channels?limit=1000
Authorization: Bearer <oauth_token>
Accept: application/vnd.urbanairship+json; version=3
limit=1000 for optimal performancenext_page URL for subsequent requestsnext_page is nullnpx claudepluginhub urbanairship/agent-tools --plugin airshipGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.