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

# Search Issuers

> Full-text search across MiCA-registered entities

Search entities by name, LEI, commercial name, or national authority. This is a dedicated search endpoint optimized for quick lookups. For advanced filtering and pagination, use [List Issuers](/endpoints/mica-register/list-issuers) instead.

## Query Parameters

<ParamField query="q" type="string" required>
  Search query. Minimum 2 characters, maximum 200. Matched against `entityName`, `entityIdentifier`, `commercialName`, and `nationalAuthority`.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Maximum number of results. Capped at `100`.
</ParamField>

## Response Fields

<ResponseField name="success" type="boolean">Request status</ResponseField>
<ResponseField name="data" type="array">Array of matching issuer objects</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable>
    <ResponseField name="total" type="integer">Number of matches returned</ResponseField>
    <ResponseField name="returned" type="integer">Number of matches returned</ResponseField>
    <ResponseField name="query" type="string">Echoed search query (trimmed)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable>
    <ResponseField name="source" type="string">Data source</ResponseField>
    <ResponseField name="timestamp" type="string">ISO 8601 response timestamp</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/api/mica/v1/search?q=bitpanda&limit=5" \
    -H "X-API-Key: trusset_mica_your_key_here"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.trusset.org/api/mica/v1/search?q=bitpanda&limit=5',
    { headers: { 'X-API-Key': 'trusset_mica_your_key_here' } }
  );
  const { data: results } = await response.json();
  ```

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

  response = requests.get(
      'https://api.trusset.org/api/mica/v1/search',
      headers={'X-API-Key': 'trusset_mica_your_key_here'},
      params={'q': 'bitpanda', 'limit': 5}
  )
  results = response.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "clx_def456",
        "entityName": "Bitpanda GmbH",
        "entityIdentifier": "529900EXAMPLE00LEI01",
        "licenseType": "CASP",
        "entityType": "provider",
        "country": "Austria",
        "countryCode": "AT",
        "nationalAuthority": "FMA",
        "authorizationDate": "2025-01-15T00:00:00.000Z",
        "status": "active"
      }
    ],
    "pagination": {
      "total": 1,
      "returned": 1,
      "query": "bitpanda"
    },
    "metadata": {
      "source": "cache",
      "timestamp": "2025-06-15T12:00:00.000Z"
    }
  }
  ```

  ```json Error - Query Too Short theme={null}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "Search query (q) must be at least 2 characters"
    }
  }
  ```
</ResponseExample>