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

# Find a Group by Name

> Use cURL to search for a group in Lumos by its name.

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
       --url 'https://api.lumos.com/groups?name=<SEARCH_STRING>&page=1&size=50' \
       --header 'accept: application/json' \
       --header 'authorization: Bearer <YOUR_API_TOKEN>' | jq .
  ```
</RequestExample>

<ResponseExample>
  ```json Response Example theme={null}
  {
    "items":	{
        "id": "1234",
        "app_id": "12345",
        "integration_specific_id": "asdf1234",
        "name": "My Group Name with <SEARCH_STRING> in it.",
        "description": "Here's a group I can find via search!",
        "lifecycle": "SYNCED",
        "source_app_id": "okta.com"
      }
    ],
    "total": 1,
    "page": 1,
    "size": 50
  }
  ```
</ResponseExample>

<Steps>
  <Step title="Set a prefix to search">
    Replace `<SEARCH_STRING>` with some group prefix that you want to search by. The API will return groups that contain that SEARCH\_STRING in their name.
  </Step>

  <Step title="Set the API_TOKEN and pretty print">
    Replace your API Token that you created at [https://app.lumosidentity.com/settings/api\_tokens](https://app.lumosidentity.com/settings/api_tokens). Pipe the output into "jq" to print the JSON response in a readable format.
  </Step>
</Steps>