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

# List All Senders

> Retrieve a list of all sender identities associated with your account.

This endpoint returns a list of all sender IDs—such as alphanumeric names or registered short codes—that are authorized for use on your account.

### Headers

<ParamField header="X-API-Key" type="string" required placeholder="gliiv_xxxxxxxxxxxxxxxx">
  Your secret API key used to authenticate the request.
</ParamField>

### Query Parameters

<ParamField query="sortBy" type="string" required={false}>
  The field used to sort the results.

  *Choices:* `balance`, `createdAt`
</ParamField>

<ParamField query="sortDirection" type="string" required={false}>
  The direction of the sort.

  *Choices:* `asc`, `desc`
</ParamField>

<ParamField query="page" default={1} type="number" required={false}>
  The page number to retrieve for pagination.
</ParamField>

<ParamField query="limit" default={50} type="number" required={false}>
  The number of sender records to return per page.
</ParamField>

### Response Body

<ResponseField name="senders" type="object[]">
  An array of authorized sender objects.

  <Expandable title="Sender Object Details">
    <ResponseField name="id" type="string">
      The unique identifier for the sender.
    </ResponseField>

    <ResponseField name="name" type="string">
      The alphanumeric label or short code.
    </ResponseField>

    <ResponseField name="balance" type="number">
      The specific credit balance allocated to this sender.
    </ResponseField>

    <ResponseField name="user" type="object">
      Information about the owner of the sender identity.

      <Expandable title="User Details">
        <ResponseField name="name" type="string">
          The name of the user.
        </ResponseField>

        <ResponseField name="id" type="string">
          The unique identifier of the user.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      The ISO 8601 timestamp of creation.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      The ISO 8601 timestamp of the last update.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  The total count of sender identities available.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
      "senders": [
          {
              "id": "<string>",
              "name": "<string>",
              "balance": "<number>",
              "user": {
                  "name": "<string>",
                  "id": "<string>"
              },
              "createdAt": "<string>",
              "updatedAt": "<string>"
          }
          "..."
      ],
      "total": "<number>"
  }
  ```

  ```json 401 theme={null}
  {
    "message": "Authentication required",
    "status": 401
  }
  ```

  ```json 500 theme={null}
  {
      "message": "Internal server error",
      "status": 500
  }
  ```
</ResponseExample>