> ## Documentation Index > Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Obtener contacto por UUID > Devuelve un contacto del business identificado por su UUID. Si no existe o pertenece a otro business, responde 404 (CONTACT_NOT_FOUND) sin distinguir para no exponer enumeración de UUIDs ajenos. ## OpenAPI ````yaml /openapi.json get /{slug}/contacts/{uuid} openapi: 3.1.0 info: title: 1TO1 AI Public API version: 0.2.0 description: >- API pública de 1TO1 AI para integraciones externas (n8n, CRMs, scripts). Auth via Bearer token. Rate limit 60 req/min por API key. Contrato REST puro: el body de éxito es el payload directo (status HTTP como señal), errores retornan `{code, message}` con ambos campos garantizados. Ver schema `PublicError`. servers: - url: https://app.1to1.ai/api/v1/public description: Producción security: - bearerAuth: [] paths: /{slug}/contacts/{uuid}: get: tags: - Contacts summary: Obtener contacto por UUID description: >- Devuelve un contacto del business identificado por su UUID. Si no existe o pertenece a otro business, responde 404 (CONTACT_NOT_FOUND) sin distinguir para no exponer enumeración de UUIDs ajenos. parameters: - $ref: '#/components/parameters/SlugPathParam' - schema: type: string format: uuid description: UUID del contacto required: true description: UUID del contacto name: uuid in: path responses: '200': description: OK headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/ContactItem' '400': description: UUID inválido en el path (INVALID_REQUEST) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Token ausente, mal formado o no válido (INVALID_API_TOKEN) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- El slug del path no coincide con el business del token (TOKEN_BUSINESS_MISMATCH) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '404': description: Contacto no encontrado (CONTACT_NOT_FOUND) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit excedido (RATE_LIMIT_EXCEEDED). Headers `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` indican cuándo reintentar. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '500': description: Error inesperado del servidor (UNKNOWN_ERROR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' components: parameters: SlugPathParam: schema: $ref: '#/components/schemas/SlugPathParam' required: true description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. name: slug in: path schemas: ContactItem: type: object properties: uuid: type: string format: uuid first_name: type: - string - 'null' middle_name: type: - string - 'null' last_name: type: - string - 'null' second_last_name: type: - string - 'null' full_name: type: - string - 'null' example: Mariana López whatsapp_id: type: - string - 'null' example: '525511223344' description: >- Teléfono del contacto (`wa_id` sin `+`). Identificador legacy; coexiste con `whatsapp_user_id`. whatsapp_user_id: type: - string - 'null' example: MX.2658176374597251 description: >- Identificador forward-compatible del contacto. Devuelve el BSUID real cuando el contacto lo tiene; mientras Meta no migre, hace fallback al `wa_id` (`whatsapp_id`) para que siempre haya un valor resoluble. Si el contacto aún no tiene BSUID, este campo trae el teléfono: para resolver una conversación reenvíalo como `phone`, no como `whatsapp_user_id` (el resolver solo acepta BSUIDs reales y daría `404`). **Recomendado** para nuevos clientes. whatsapp_username: type: - string - 'null' example: mariana.lopez description: >- Username público de WhatsApp del contacto (sin `@`). Best-effort: es el último username observado por la plataforma y el usuario puede cambiarlo — útil para display y como identificador de resolución secundario (`username` en `ConversationRef`), nunca como clave estable (esa es `uuid`). acquisition_source: type: string example: whatsapp is_tester: type: boolean description: >- Contacto creado desde el módulo tester del dashboard (datos ficticios). El listado devuelve reales y tester mezclados; filtrar por este campo si el cliente solo necesita uno de los dos. Para solo-tester existe `/tester/contacts`. example: false created_at: type: string format: date-time updated_at: type: string format: date-time required: - uuid - first_name - middle_name - last_name - second_last_name - full_name - whatsapp_id - whatsapp_user_id - whatsapp_username - acquisition_source - is_tester - created_at - updated_at PublicError: type: object properties: code: type: string example: INVALID_API_TOKEN message: type: string example: >- The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token. required: - code - message description: >- Public API error body. The client should match against `code` (stable canonical identifier) and NOT against `message` (human text, may be refined between API versions without notice). The HTTP status code is the error-type signal (4xx client, 5xx server). SlugPathParam: type: string example: acme description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_1to1_ description: >- API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_... ````