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

# List Assistants

> Get all assistants (legal AI specialists) that you have read access to

Get a list of all assistants available to your account. Assistants are specialized legal AI agents that can help with specific types of legal work.

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.wordsmith.ai/api/v1/assistants' \
  --header 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.wordsmith.ai/api/v1/assistants", {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  });

  const assistants = await response.json();
  console.log(assistants);
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.wordsmith.ai/api/v1/assistants"
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  response = requests.get(url, headers=headers)
  assistants = response.json()
  print(assistants)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Contract Review Assistant",
      "description": "Specialized in reviewing and analyzing legal contracts for compliance and risk assessment"
    },
    {
      "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
      "name": "Legal Research Assistant",
      "description": "Expert in conducting comprehensive legal research and case law analysis"
    },
    {
      "id": "abcdef12-3456-7890-abcd-ef1234567890",
      "name": "Document Drafting Assistant",
      "description": "Assists with drafting various legal documents including agreements, letters, and briefs"
    }
  ]
  ```
</ResponseExample>

## Response Fields

<ResponseField name="id" type="string">
  The unique identifier for the assistant
</ResponseField>

<ResponseField name="name" type="string">
  The display name of the assistant
</ResponseField>

<ResponseField name="description" type="string">
  A description of the assistant's capabilities and specializations
</ResponseField>

## Notes

* Only assistants that you have read access to will be returned
* The list includes both your organization's custom assistants and any global assistants you have access to
* Use the `id` field when creating questions with specific assistants via the [Create Question](/api-reference/assistants/create-question) endpoint