> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Buscar usuario por correo electrónico > Resuelve el `user_id` de un usuario por su correo dentro de tu organización. El correo va en el cuerpo, no en la URL, para no aparecer en registros ni análisis de solicitudes. Solo devuelve usuarios que pertenecen a tu organización (`access_type: "organization"`) o explícitamente a algún sitio no pausado de ella (`access_type: "website"`). Cualquier otro caso, incluido un usuario de otra organización, devuelve `404` con el mismo cuerpo que un correo desconocido, para impedir enumerar cuentas entre organizaciones. Requiere una clave global. Usa el `user_id` devuelto en los endpoints de miembros (p. ej., listar sus sitios o eliminar acceso) sin otra llamada de descubrimiento. ## OpenAPI ````yaml es/api-reference/openapi.json post /api/v1/users/by-email openapi: 3.1.0 info: title: API de AthenaHQ description: >- La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web y consultas para optimizar el contenido con IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Servidor de producción security: - apiKey: [] tags: - name: Basics description: Operaciones principales de la API para gestionar sitios web y consultas - name: Metrics description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA - name: Billing description: Endpoints de facturación y créditos para gestionar el uso - name: Team Management description: Endpoints para gestionar miembros del equipo e invitaciones - name: Groups description: Endpoints para gestionar grupos de sitios web - name: Content description: >- Endpoints para acceder a los datos del centro de contenidos: pestañas, URL monitorizadas y desglose de consultas por URL. - name: Pitch Workspace description: >- Endpoints para acceder a los informes del espacio de propuestas: ejecuciones de propuestas con alcance de organización, con competidores, consultas, atributos y métricas agregadas. - name: Knowledge Base description: >- Endpoints para leer la base de conocimientos de la marca: datos aprobados sobre la marca y los pilares que los organizan. paths: /api/v1/users/by-email: post: tags: - Team Management summary: Buscar usuario por correo electrónico description: >- Resuelve el `user_id` de un usuario por su correo dentro de tu organización. El correo va en el cuerpo, no en la URL, para no aparecer en registros ni análisis de solicitudes. Solo devuelve usuarios que pertenecen a tu organización (`access_type: "organization"`) o explícitamente a algún sitio no pausado de ella (`access_type: "website"`). Cualquier otro caso, incluido un usuario de otra organización, devuelve `404` con el mismo cuerpo que un correo desconocido, para impedir enumerar cuentas entre organizaciones. Requiere una clave global. Usa el `user_id` devuelto en los endpoints de miembros (p. ej., listar sus sitios o eliminar acceso) sin otra llamada de descubrimiento. operationId: getUserByEmail requestBody: required: true content: application/json: schema: type: object required: - email properties: email: type: string format: email description: >- Dirección de correo que se buscará. No distingue mayúsculas de minúsculas. responses: '200': description: Usuario encontrado en tu organización content: application/json: schema: type: object properties: user: type: object properties: user_id: type: string email: type: string first_name: type: string nullable: true last_name: type: string nullable: true access_type: type: string enum: - organization - website description: >- `organization` si el usuario pertenece a tu organización (acceso implícito a todos sus sitios web); `website` si solo pertenece explícitamente a uno o varios sitios web de tu organización. required: - user_id - email - first_name - last_name - access_type required: - user '400': description: 'Solicitud incorrecta: formato de correo no válido' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid email format '401': description: 'Sin autorización: falta la clave de API o no es válida' content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: 'Acceso denegado: se requiere una clave de API global' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Forbidden: global API key required' '404': description: 'No encontrado: no hay ningún usuario coincidente en tu organización' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: User not found '429': description: >- Demasiadas solicitudes: se ha superado el límite. Vuelve a intentarlo tras una breve pausa. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: Error: type: object description: Objeto de respuesta de error required: - error properties: error: type: string description: Mensaje de error que describe qué ha fallado example: Unauthorized securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clave de API para autenticarse. Puedes crear una [aquí](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.