Returns the full agent record including profile fields, current lifecycle state, and newsletter enablement.
Request
Agent id returned from POST /v1/rcs/agents.
Response
200 — approved agent
200 — pending review
200 — rejected
200 — draft
{
"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"
}
APPROVED — the agent can send production traffic.
Always EUROPE for agents created on this platform.
Immutable after submission. Determines which traffic_type values are allowed at send time.
true if this agent was approved with newsletter / MAU traffic enabled. Requires separate enablement — not set automatically on standard agent approval.
{
"agent_id" : "ag_draft_a1b2c3" ,
"status" : "PENDING_REVIEW" ,
"submitted_at" : "2026-03-11T10:00:00Z"
}
PENDING_REVIEW — the agent has been submitted and is awaiting approval.
{
"agent_id" : "ag_draft_a1b2c3" ,
"status" : "REJECTED" ,
"rejection_reason" : "Logo does not meet minimum resolution requirements (224×224px)." ,
"rejected_at" : "2026-03-15T08:30:00Z"
}
Human-readable reason. Fix the flagged issue and resubmit via POST /v1/rcs/agents/{id}/submit.
{
"agent_id" : "ag_draft_a1b2c3" ,
"status" : "DRAFT" ,
"created_at" : "2026-03-10T09:00:00Z"
}
DRAFT — agent has not been submitted for review yet.
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.