> ## Documentation Index
> Fetch the complete documentation index at: https://developers.phonovation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sender IDs

> Understand and manage the Sender IDs available on your Phonovation account.

The `from` field in every campaign request must be a **pre-approved Sender ID** on your account. Using an unregistered Sender ID will result in a rejected request.

```mermaid title="Sender ID selection flow" theme={"dark"}
flowchart TD
  Campaign["Prepare campaign"] --> Irish{"Sending to Irish numbers?"}
  Irish -->|Yes| Registered{"Sender ID registered with ComReg?"}
  Irish -->|No| Approved["Use an approved account Sender ID"]
  Registered -->|Yes| Send["Send campaign"]
  Registered -->|No| Request["Request Sender ID registration"]
  Request --> Active["Wait until active on your account"]
  Active --> Send
  Approved --> Send
```

## Retrieve your Sender IDs

<CodeGroup>
  ```bash title="cURL" icon="terminal" highlight={2} wrap theme={"dark"}
  curl https://api.interactsms.com/api/v2/senderlist \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```python title="Python" icon="python" lines focus={3-6} theme={"dark"}
  import requests

  res = requests.get(
      "https://api.interactsms.com/api/v2/senderlist",
      headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
  )

  print(res.json())
  ```

  ```csharp title="C#" icon="code" lines focus={5-8} theme={"dark"}
  using System.Net.Http.Headers;

  using var client = new HttpClient();
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_ACCESS_TOKEN");

  var res = await client.GetAsync("https://api.interactsms.com/api/v2/senderlist");

  Console.WriteLine(await res.Content.ReadAsStringAsync());
  ```

  ```java title="Java" icon="java" lines focus={6-10} theme={"dark"}
  import java.net.URI;
  import java.net.http.HttpClient;
  import java.net.http.HttpRequest;
  import java.net.http.HttpResponse;

  HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://api.interactsms.com/api/v2/senderlist"))
      .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
      .GET()
      .build();

  HttpResponse<String> res = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
  System.out.println(res.body());
  ```

  ```php title="PHP" icon="php" lines focus={3-5} theme={"dark"}
  $client = new GuzzleHttp\Client();

  $res = $client->get('https://api.interactsms.com/api/v2/senderlist', [
      'headers' => ['Authorization' => 'Bearer YOUR_ACCESS_TOKEN'],
  ]);

  echo $res->getBody();
  ```

  ```js title="JavaScript" icon="js" lines focus={1-5} theme={"dark"}
  const res = await fetch("https://api.interactsms.com/api/v2/senderlist", {
    headers: {
      Authorization: "Bearer YOUR_ACCESS_TOKEN",
    },
  });

  console.log(await res.json());
  ```
</CodeGroup>

**Response:**

```json title="Sender ID response" icon="code" highlight={2-4} wrap theme={"dark"}
[
  { "name": "Phonovation", "type": 0 },
  { "name": "353851234567", "type": 2 },
  { "name": "FreeText", "type": 1 }
]
```

## Sender ID types

| Type | Name                    | Description                                                 |
| ---- | ----------------------- | ----------------------------------------------------------- |
| `0`  | ComReg Sender ID        | Registered with ComReg. Delivers to Irish numbers.          |
| `1`  | International Sender ID | Non-ComReg approved. **Will not deliver to Irish numbers.** |
| `2`  | Numeric Sender ID       | A phone number. Supports two-way messaging.                 |

<Warning>
  Type `1` (International / non-ComReg) Sender IDs **cannot be used to send to Irish numbers**. Use a Type `0` or Type `2` Sender ID for Irish recipients.
</Warning>

## ComReg registration

In Ireland, **all alphanumeric Sender IDs must be registered with ComReg** (Commission for Communications Regulation) before they can be used to send to Irish numbers. This is a legal requirement — unregistered Sender IDs will not deliver to Irish recipients.

Phonovation handles the ComReg registration process on your behalf. When you request a new Sender ID, Phonovation submits it for approval before activating it on your account.

<Info>
  ComReg registration applies to alphanumeric Sender IDs (e.g. `YourBrand`). Numeric Sender IDs (dedicated longcodes or shortcodes) follow a separate provisioning process.
</Info>

## Registering a new Sender ID

Contact [support@phonovation.com](mailto:support@phonovation.com) to request a new Sender ID. Include:

* The exact Sender ID you want (max 11 characters for alphanumeric)
* Whether it will be used for marketing or transactional messages

Allow time for ComReg processing before the Sender ID becomes active.