GET /v1/rcs/agents/{id}
Returns the full agent record including profile fields, current lifecycle state, and newsletter enablement.

Request

Authorization
string
required
Bearer <api_key>
id
string
required
Agent id returned from POST /v1/rcs/agents.

Response

{
  "agent_id": "ag_live_xxxx",
  "status": "APPROVED",
  "display_name": "FreshFood Official",
  "description": "Order updates and exclusive offers from FreshFood.",
  "logo_url": "https://cdn.freshfood.de/brand/logo-224.png",
  "website": "https://www.freshfood.de",
  "region": "EUROPE",
  "use_case": "MULTI_USE",
  "billing_category": "NON_CONVERSATIONAL",
  "newsletter_enabled": true,
  "approved_at": "2026-03-20T14:00:00Z",
  "created_at": "2026-03-10T09:00:00Z"
}
status
string
APPROVED — the agent can send production traffic.
region
string
Always EUROPE for agents created on this platform.
use_case
string
Immutable after submission. Determines which traffic_type values are allowed at send time.
newsletter_enabled
boolean
true if this agent was approved with newsletter / MAU traffic enabled. Requires separate enablement — not set automatically on standard agent approval.

Update agent

Edit agent profile fields before or after rejection.

Submit agent

Submit for review when all required fields are complete.

Launch status

Check carrier launch progress for an approved agent.