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

# Get customer tags

> List the tags set on customers.

See [Customer tags](/product/customer-tags) for what they do in the dashboard.

## Parameters

<ParamField query="customer_names" type="list[string]">
  Specify the names of the customers whose tags should be fetched. Not setting it means "all customers".
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Numbers of customers to fetch. Max `1000`.
</ParamField>

<ParamField query="cursor" type="string">
  The route is paginated: pass the previous page's `next_cursor` to fetch the next page. PS: `has_more` from the output says whether another page exists.
</ParamField>

<RequestExample>
  ```python Python theme={null}
  import weflayr

  client = weflayr.client()  # reads WEFLAYR_API_KEY

  client.get_customers_tags(customer_names=["c_123", "c_456"])
  ```

  ```js Node.js theme={null}
  const weflayr = require('weflayr');

  const client = weflayr.client(); // reads WEFLAYR_API_KEY

  await weflayr.api.getCustomersTags({
    client,
    throwOnError: true,
    query: { customerNames: ['c_123', 'c_456'] },
  });
  ```

  ```bash cURL theme={null}
  curl "https://app.weflayr.com/api/customer-tags/?customer_names=c_123&customer_names=c_456" \
    -H "Authorization: Bearer $WEFLAYR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "customers": [
      {"customer_name": "c_123", "tags": {"plan": "enterprise", "region": "EU"}},
      {"customer_name": "c_456", "tags": {"plan": "free"}}
    ],
    "next_cursor": null,
    "has_more": false
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.