# List RCS agents

Returns RCS agents.

```http
GET https://api.pozy.ai/v1/rcs/agents
```

- Area: Messaging / RCS
- Auth: Authorization: Bearer pz_live_...

## Query parameters

- `includeClosed` (boolean)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/rcs/agents" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/rcs/agents", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/rcs/agents",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `agents`, array of object
  - `id`, string
  - `profileId`, string
  - `accountId`, string: Can be null
  - `country`, string
  - `status`, string: One of `requested`, `changes_requested`, `brand_vetting`, `agent_review`, `testing`, `launch_review`, `launching`, `live`, `rejected`, `deactivated`
  - `displayName`, string: Up to 40 characters
  - `useCase`, string: One of `MULTI_USE`, `PROMOTIONAL`, `TRANSACTIONAL`, `OTP`
  - `profile`, object
    - `description`, string, required: Up to 100 characters
    - `logoUrl`, string (URL), required
    - `heroUrl`, string (URL), required
    - `brandColor`, string, required
    - `privacyPolicyUrl`, string (URL), required
    - `termsUrl`, string (URL), required
    - `phone`, object
      - `number`, string, required
      - `label`, string, required: Up to 25 characters
    - `website`, object
      - `url`, string (URL), required
      - `label`, string, required: Up to 25 characters
    - `email`, object
      - `address`, string (email), required
      - `label`, string, required: Up to 25 characters
  - `brand`, object
    - one of: Rcs Brand
      - `displayName`, string, required: Up to 100 characters
      - `legalName`, string, required: Up to 100 characters
      - `legalEntityType`, string, required: One of `LIMITED_LIABILITY_COMPANY`, `SOLE_PROPRIETORSHIP`, `PARTNERSHIP`, `CORPORATION`, `S_CORPORATION`
      - `organizationType`, string, required: One of `PRIVATE_PROFIT`, `PUBLIC_PROFIT`, `NON_PROFIT`, `GOVERNMENT`
      - `websiteUrl`, string (URL), required
      - `taxId`, string, required
      - `stockSymbol`, string
      - `address`, object, required
        - `line1`, string, required
        - `line2`, string
        - `city`, string, required
        - `state`, string
        - `postalCode`, string, required
        - `country`, string, required: One of `US`, `GB`, `AT`, `BD`, `BR`, `CD`, `DE`, `ES`, `FR`, `IN`, `IT`, `MX`, `NG`, `NL`, `NO`, `PT`, `SE`, `SG`, `ZA`
      - `contact`, object, required
        - `firstName`, string, required
        - `lastName`, string, required
        - `title`, string
        - `email`, string (email), required
        - `phone`, string, required
      - `id`, string
      - `status`, string: One of `draft`, `vetting`, `verified`, `rejected`
      - `createdAt`, string (date-time)
  - `launchRequest`, object
    - one of: Rcs Launch Request
      - `companyOverview`, string, required: Up to 2000 characters
      - `agentOverview`, string, required: Up to 2000 characters
      - `interactions`, array of object, required: At least 1 item
        - `type`, string, required: One of `TRANSACTIONAL_UPDATES`, `CUSTOMER_SUPPORT`, `LOYALTY_OR_REWARD`, `MARKETING_OR_PROMOTIONAL`, `ACCOUNT_ALERTS`, `TWO_WAY_CONVERSATION`, `OTHER`
        - `description`, string
      - `messageExamples`, array of string, required: At least 3 items. Up to 10 items. Each item: up to 2000 characters
      - `consent`, object, required
        - `optInMethods`, array of object, required: At least 1 item
          - `type`, string, required: One of `SMS`, `WEBSITE`, `MOBILE_APP`, `QR_CODE`, `SALE_POINT`, `OTHER`
          - `description`, string
        - `callToAction`, string, required
        - `callToActionUrl`, string (URL)
        - `callToActionMediaUrl`, string (URL)
        - `doubleOptIn`, boolean, required
        - `doubleOptInMessage`, string
        - `optInMessage`, string, required
        - `helpResponse`, string, required
        - `optOutResponse`, string, required
      - `testVideoUrl`, string (URL), required
      - `additionalInformation`, string: Up to 2000 characters
  - `carrierApprovals`, array of object
    - `approvalId`, string
    - `scope`, string: One of `carrier`, `hub`, `bot`
    - `status`, string: One of `PENDING`, `SUBMITTED`, `APPROVED`, `REJECTED`
    - `carrier`, string: Can be null
    - `approvedAt`, string (date-time): Can be null
    - `rejectedReason`, string: Can be null
  - `testDevices`, array of object
    - `testDeviceId`, string
    - `phoneNumber`, string
    - `inviteStatus`, string: One of `PENDING`, `ACCEPTED`, `DECLINED`
  - `smsFallbackFrom`, string: Can be null
  - `reviewNote`, string: Can be null
  - `declineReason`, string: Can be null
  - `requestedAt`, string (date-time): Can be null
  - `submittedAt`, string (date-time): Can be null
  - `liveAt`, string (date-time): Can be null
  - `createdAt`, string (date-time)

```json
{
  "agents": [
    {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "profileId": "6a0b6573846efc28aaa9a3ff",
      "accountId": "696e0b682d0a31188e7a2ba9",
      "country": "US",
      "status": "requested",
      "displayName": "Acme",
      "useCase": "MULTI_USE",
      "profile": {
        "description": "A short description",
        "logoUrl": "https://pozy.ai/media/example-1.jpg",
        "heroUrl": "https://pozy.ai/media/example-1.jpg",
        "brandColor": "string",
        "privacyPolicyUrl": "https://pozy.ai/media/example-1.jpg",
        "termsUrl": "https://pozy.ai/media/example-1.jpg",
        "phone": {
          "number": "string",
          "label": "string"
        },
        "website": {
          "url": "https://pozy.ai/media/example-1.jpg",
          "label": "string"
        },
        "email": {
          "address": "alex@example.com",
          "label": "string"
        }
      },
      "brand": {
        "displayName": "Acme",
        "legalName": "Acme",
        "legalEntityType": "LIMITED_LIABILITY_COMPANY",
        "organizationType": "PRIVATE_PROFIT",
        "websiteUrl": "https://pozy.ai/media/example-1.jpg",
        "taxId": "6e274285e4e83c5f91aee85e",
        "stockSymbol": "string",
        "address": {
          "line1": "string",
          "line2": "string",
          "city": "string",
          "state": "string",
          "postalCode": "string",
          "country": "US"
        },
        "contact": {
          "firstName": "Acme",
          "lastName": "Acme",
          "title": "Launch day",
          "email": "alex@example.com",
          "phone": "+14155550123"
        },
        "id": "6bfebd43ddc270f6d2c56fc5",
        "status": "draft",
        "createdAt": "2026-10-02T09:00:00.000Z"
      },
      "launchRequest": {
        "companyOverview": "string",
        "agentOverview": "string",
        "interactions": [
          {
            "type": "TRANSACTIONAL_UPDATES",
            "description": "A short description"
          }
        ],
        "messageExamples": [
          "Hello from Pozy"
        ],
        "consent": {
          "optInMethods": [
            {
              "type": "SMS",
              "description": "A short description"
            }
          ],
          "callToAction": "string",
          "callToActionUrl": "https://pozy.ai/media/example-1.jpg",
          "callToActionMediaUrl": "https://pozy.ai/media/example-1.jpg",
          "doubleOptIn": true,
          "doubleOptInMessage": "Hello from Pozy",
          "optInMessage": "Hello from Pozy",
          "helpResponse": "string",
          "optOutResponse": "string"
        },
        "testVideoUrl": "https://pozy.ai/media/example-1.jpg",
        "additionalInformation": "string"
      },
      "carrierApprovals": [
        {
          "approvalId": "66666666666666661f2e3d4c",
          "scope": "carrier",
          "status": "PENDING",
          "carrier": "string",
          "approvedAt": "2026-10-02T09:00:00.000Z",
          "rejectedReason": "string"
        }
      ],
      "testDevices": [
        {
          "testDeviceId": "653426651346b544a97028d1",
          "phoneNumber": "+14155550123",
          "inviteStatus": "PENDING"
        }
      ],
      "smsFallbackFrom": "string",
      "reviewNote": "string",
      "declineReason": "string",
      "requestedAt": "2026-10-02T09:00:00.000Z",
      "submittedAt": "2026-10-02T09:00:00.000Z",
      "liveAt": "2026-10-02T09:00:00.000Z",
      "createdAt": "2026-10-02T09:00:00.000Z"
    }
  ]
}
```