> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/identity-api/identity-api-reference/users/users-management/search-user.md).

# Search User

Realiza una búsqueda de reconocimiento facial 1:N dentro de la colección. Devuelve los usuarios que coinciden y que cumplen con el umbral de similitud configurado.

### Endpoint

```
POST /users/search
```

### Autenticación

| Tipo    | Ubicación | Nombre        |
| ------- | --------- | ------------- |
| API Key | Header    | **x-api-key** |

### Cuerpo de la solicitud

**Content-Type:** `application/json`

#### Parámetros

| Parámetro   | Tipo   | Requerido | Descripción                                                                                                                                                                |
| ----------- | ------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `face`      | string | **Sí**    | Imagen del rostro del usuario **codificada en Base64** o tokenizada. Para imágenes abiertas, los formatos soportados son **JPEG** y **PNG**. Tamaño máximo soportado: 5MB. |
| `threshold` | number | No        | Valor que especifica la confianza mínima en la coincidencia facial para devolver un resultado. El valor por defecto es **80%**.                                            |

#### Ejemplo de solicitud

```json
{
  "face": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "threshold": 75.5
}
```

### Respuestas

#### `200` Éxito

#### Parámetros de respuesta

| Parámetro              | Tipo   | Descripción                                                                            |
| ---------------------- | ------ | -------------------------------------------------------------------------------------- |
| `matches`              | array  | Array de usuarios coincidentes ordenados por puntuación de similitud de mayor a menor. |
| `matches[].userId`     | string | Identificador único del usuario coincidente.                                           |
| `matches[].similarity` | number | Puntuación de similitud entre 0 y 100, indicando la confianza de la coincidencia.      |

#### Ejemplo de respuesta

```json
{
  "matches": [
    {
      "userId": "f7eab18f-e5d3-4dac-9d4d-cfb969ef848e",
      "similarity": 99.99953
    }
  ]
}
```

#### `400` Bad Request

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Unauthorized

```json
{
  "message": "Unauthorized"
}
```

#### `403` Forbidden

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `404` Not Found

```json
{
  "status": 404,
  "title": "Not Found",
  "detail": "The server can't find the requested resource.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404"
}
```