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

# Retrieve all brands

> List all 10DLC brands associated with your account

This API lets you fetch all the brands associated with an account.

#### API Endpoint

```text GET theme={null}
https://api.plivo.com/v1/Account/{auth_id}/10dlc/Brand/
```

### Arguments

<table>
  <tbody>
    <tr>
      <td>
        <strong>limit<br />integer</strong>
      </td>

      <td>
        Denotes the number of results per page. The maximum number of results that can be fetched is 20. Defaults to 20.
      </td>
    </tr>

    <tr>
      <td>
        <strong>offset <br />integer</strong>
      </td>

      <td>
        Denotes the number of value items by which the results should be offset. Defaults to 0. Read more about <a href="https://docs.plivo.com/docs/messaging/api/request/pagination">offset-based pagination</a>.
      </td>
    </tr>

    <tr>
      <td>
        <strong>registration\_status<br />string</strong>
      </td>

      <td>
        Filter by registration\_status. Allowed values: FAILED, PROCESSING, COMPLETED
      </td>
    </tr>

    <tr>
      <td>
        <strong>type<br />string</strong>
      </td>

      <td>
        Filter by registration type. Allowed values: STARTER, STANDARD
      </td>
    </tr>
  </tbody>
</table>

### Returns

api\_id and a dictionary with an objects property that contains up to 20 brands. Each tuple in the list is a separate Brand object.

<RequestExample>
  ```py Python theme={null}
  import plivo

  client = plivo.RestClient("<auth_id>", "<auth_token>")
  response = client.campaign.list(limit=1, offset=0)
  print(response)
  ```

  ```ruby Ruby theme={null}
  require "rubygems"
  require "/etc/plivo-ruby/lib/plivo.rb"
  include Plivo

  api = RestClient.new("<auth_id>", "<auth_token>")

  begin
  response = api.brand.list(limit: 1, offset: 0)

  puts response
  rescue PlivoRESTError => e
      puts 'Exception: ' + e.message
  end
  ```

  ```js Node theme={null}
  let plivo = require('plivo');

  let client = new plivo.Client("<auth_id>", "<auth_token>");
  client.brand.list()
      .then(function (response) {
          console.log(JSON.stringify(response));
      }).catch(function (error) {
          console.log("err");
          console.log(error);
      });
  ```

  ```php PHP theme={null}
  <?php

  # Available in versions >= 4.29.0 (https://github.com/plivo/plivo-php/releases/tag/v4.29.0)

  require '/etc/plivo-php/vendor/autoload.php';
  use Plivo\RestClient;
  $client = new RestClient("<auth_id>", "<auth_token>");
  $client
      ->client
      ->setTimeout(60);
  try
  {
      $res = $client
          ->brand
          ->list();
      print_r($res);
  }
  catch(PlivoRestException $ex)
  {
      print_r($ex);
  }
  ?>
  ```

  ```java Java theme={null}
  package com.plivo.examples;

  import com.plivo.api.Plivo;
  import com.plivo.api.models.base.ListResponse;
  import com.plivo.api.models.brand.Brand;

  public class PlivoTest {

      public static void main(String[] args) {

          Plivo.init("<auth_id>", "<auth_token>");

          // List Brand
          try {
              ListResponse < Brand > response = Brand.lister().limit(1).offset(2).list();
              System.out.println(response);
          } catch (Exception e) {
              e.printStackTrace();
          }
      }
  }
  ```

  ```csharp .NET theme={null}
  using System;
  using System.Collections.Generic;
  using Plivo;
  using Plivo.Exception;

  namespace dotnet_project
  {
      class Ten_dlc
      {
          static void Main(string[] args)
          {

              var api = new PlivoApi("<auth_id>", "<auth_token>");

              // List Brand
              Console.WriteLine("List Brand");
              try
              {
                  var response = api.Brand.List();
                  Console.WriteLine(response);
              }
              catch (PlivoRestException e)
              {
                  Console.WriteLine("Exception: " + e.Message);
              }
          }
      }
  }
  ```

  ```go Go theme={null}
  package main

  import (
          "fmt"
          "os"

          plivo "github.com/plivo/plivo-go/v7"
  )

  func main() {
          client, err := plivo.NewClient("<auth_id>", "<auth_token>", &plivo.ClientOptions{})
          if err != nil {
                  panic(err)
          }
          //List Brands
          response, err := client.Brand.List(plivo.BrandListParams{Limit: 1, Offset: 0})
          if err != nil {
                  fmt.Printf("Error occurred while getting brands. error:%+v\n", err)
                  os.Exit(1)
          } else {
                  fmt.Printf("%+v\n", response)
          }
  }
  ```

  ```sh cURL theme={null}
  curl -i --user auth_id:auth_token \
      https://api.plivo.com/v1/Account/{auth_id}/10dlc/Brand/  
  ```
</RequestExample>

### Response

```json Response theme={null}
{
   "api_id":"553379bc-6c9a-4f5d-8e8f-e0999euejene8",
   "meta":{
      "limit":1,
      "offset":0,
      "next":"/v1/Account/<AUTH_ID>/10dlc/Brand/?limit=1&offset=1",
      "previous":null,
      "total_count":45
   },
   "brands":[
      {
    	"brand_alias": "sample name",
        "brand_id": "BXXXXX",
        "brand_type": "STANDARD",
        "company_name": "sample company",
        "ein": "123456789",
        "ein_issuing_country": "US",
        "entity_type": "PUBLIC",
        "profile_uuid": "7b8ff904-a1d2-46b2-888d-34d4df4cf95a",
        "registration_status": "COMPLETED",
        "vertical": "COMMUNICATION",
        "vetting_score": 80,
        "vetting_status": "ACTIVE",
        "website": "www.samplewebsite.com"
        "Address":{
            "city": "Dallas",
            "country": "US",
            "postal_code": "10001",
            "state": "Texas",
            "street": "#11, Nashville Street"
            },
        "Authorized_contact":{
            "email": "xxxx@gmail.com",
            "first_name": "John",
            "last_name": "Doe",
            "phone": "14845355113",
            "seniority": "Admin",
            "title": "Mr"
            },
        "created_at":"2023-03-06T20:59:26.040592Z"
          }
   ]
}
```