GET /v1/rcs/agents/{id}/launch
Returns the per-carrier launch status of an approved agent. Google approval is a prerequisite — the agent must be in APPROVED state before this endpoint returns carrier data.

​
Request

​
Authorization
string
required
Bearer <api_key>
​
id
string
required
Agent ID. Must be APPROVED.

​
Launch states

Each carrier progresses through Google’s launch state machine independently. The status field on each carrier entry maps to the Google AgentLaunchEvent.LaunchState enum:
StatusMeaning
UNLAUNCHEDAgent has not been submitted for launch on this carrier.
PENDINGLaunch is under review by the carrier.
LAUNCHEDAgent is live — you can send to numbers on this carrier.
REJECTEDCarrier rejected the launch. Check rejection_reason for details.
SUSPENDEDPreviously launched, but suspended by the carrier or Google. Sends will fail.
LAUNCH_STATE_UNSPECIFIED is an internal Google default and is never returned by the Arowana API.

​
Response

{
  "agent_id": "ag_live_xxxx",
  "agent_status": "APPROVED",
  "carriers": [
    {
      "carrier": "vodafone_de",
      "status": "LAUNCHED",
      "launched_at": "2026-03-21T10:00:00Z"
    },
    {
      "carrier": "telekom_de",
      "status": "LAUNCHED",
      "launched_at": "2026-03-22T08:00:00Z"
    },
    {
      "carrier": "telefonica_de",
      "status": "PENDING",
      "launched_at": null
    }
  ]
}
​
carriers[].carrier
string
Carrier identifier. Currently supported carriers: vodafone_de, telekom_de, telefonica_de.
​
carriers[].status
string
One of UNLAUNCHED, PENDING, LAUNCHED, REJECTED, or SUSPENDED. See the launch states table above.
​
carriers[].launched_at
string | null
ISO 8601 timestamp when the carrier activated the agent. null for any status other than LAUNCHED.
​
carriers[].rejection_reason
string | null
Present only when status is REJECTED. Contains the carrier’s rejection reason.
Carrier activation follows Google approval and is not instantaneous. Expect a few days between Google approval and full carrier coverage. Sends to numbers on carriers that are not LAUNCHED will fail.

Get agent

Full agent details including Google approval status.

Submit agent

Submit for Google review and common rejection reasons.