> ## Documentation Index > Fetch the complete documentation index at: https://docs.revem.ai/llms.txt > Use this file to discover all available pages before exploring further. # Obtener un contacto > Devuelve un contacto por su id, en la misma forma plana que acepta el upsert. Responde el mismo `404` si el contacto no existe, está en la papelera o pertenece a otro tenant. ## OpenAPI ````yaml /openapi.json get /contacts/public/v1/{id} openapi: 3.1.0 info: title: Revem API version: 1.0.0 description: >- La API pública de Revem para integraciones de servidor a servidor: contactos, tickets y el canal de webchat. Se autentica con la API key de tu organización. contact: name: Soporte Revem email: soporte@revem.ai url: https://revem.ai servers: - url: https://api.revem.ai description: Producción security: - apiKey: [] tags: - name: Contactos description: >- Sincroniza tu base de clientes con Revem. Los contactos se identifican por teléfono al crearlos y por id después. - name: Tickets description: Lee y actualiza los tickets de tu embudo desde tu sistema de gestión. - name: Webchat description: >- Conecta el chat de tu sitio con Revem: registra lo que escribe el visitante y lee las respuestas del equipo o del agente. paths: /contacts/public/v1/{id}: get: tags: - Contactos summary: Obtener un contacto description: >- Devuelve un contacto por su id, en la misma forma plana que acepta el upsert. Responde el mismo `404` si el contacto no existe, está en la papelera o pertenece a otro tenant. operationId: getContact parameters: - name: id in: path required: true description: Id del contacto en Revem. schema: type: string format: uuid responses: '200': description: El contacto. content: application/json: schema: $ref: '#/components/schemas/Contact' '400': description: El id no es un UUID. content: application/json: schema: $ref: '#/components/schemas/ContactsError' '401': description: Sin credencial, o la API key no existe o fue revocada. content: application/json: schema: $ref: '#/components/schemas/AuthError' example: error: Unauthorized message: Invalid API key '403': description: >- La credencial no puede usar esta ruta. Una API key sólo alcanza los endpoints documentados aquí; cualquier otra ruta de la API responde este código. content: application/json: schema: $ref: '#/components/schemas/AuthError' example: ok: false error: Forbidden message: This endpoint is not available to API keys '404': description: No hay un contacto visible con ese id. content: application/json: schema: $ref: '#/components/schemas/ContactsError' example: ok: false error: Not Found message: No existe un contacto con ese id '429': description: >- La key superó su límite de solicitudes por minuto. El header `retry-after` indica cuánto esperar. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' example: ok: false error: Too many requests. Retry in 1 minute. headers: retry-after: description: Segundos que esperar antes de reintentar. schema: type: integer x-ratelimit-limit: description: Solicitudes permitidas por minuto. schema: type: integer x-ratelimit-remaining: description: Solicitudes que quedan en la ventana actual. schema: type: integer x-ratelimit-reset: description: Segundos hasta que la ventana se reinicia. schema: type: integer components: schemas: Contact: type: object properties: id: type: string format: uuid description: >- Identificador del contacto en Revem. Es el que acepta `PATCH /contacts/public/v1/{id}` y `contact.id` en webchat. phone_number: anyOf: - type: string - type: 'null' description: >- Siempre presente. Es `null` cuando el contacto llegó por un canal sin teléfono (por ejemplo Instagram); ese contacto no puede escribirse con `POST`, sólo con `PATCH /{id}`. first_name: type: string description: Nombre. Omitido cuando no se conoce. last_name: type: string description: Apellido. Omitido cuando no se conoce. email: type: string description: Omitido cuando no se conoce. created_at: type: string format: date-time description: Fecha de creación, ISO 8601 en UTC. updated_at: type: string format: date-time description: Última modificación, ISO 8601 en UTC. required: - id - phone_number - created_at - updated_at additionalProperties: true description: >- Un contacto, con sus atributos personalizados al mismo nivel que los campos fijos, identificados por nombre. Un campo que no tiene valor se omite en vez de enviarse como `null`. example: id: 3f2b6c1e-8d4a-4f0b-9c2e-7a1d5e6f8b90 phone_number: '+56912345678' first_name: Camila last_name: Rojas email: camila@ejemplo.cl created_at: '2026-08-12T14:03:22.000Z' updated_at: '2026-09-01T09:41:05.000Z' programa: Premium fecha_ultima_compra: '2026-08-30' ContactsError: type: object properties: ok: type: boolean const: false error: type: string description: >- Etiqueta del código HTTP (`Bad Request`, `Conflict`, `Unprocessable Entity`…). message: type: string description: Explicación legible del problema. unknownAttributes: type: array items: type: string description: >- Presente en el `422` por atributos desconocidos: los nombres que el tenant no tiene definidos. required: - error additionalProperties: false AuthError: type: object properties: ok: type: boolean const: false description: Presente sólo en el `403`. error: type: string message: type: string required: - error - message RateLimitError: type: object properties: ok: type: boolean const: false error: type: string description: Incluye cuánto esperar antes de reintentar. required: - ok - error securitySchemes: apiKey: type: http scheme: bearer description: >- La API key de tu organización, con la forma `rvm_.`, enviada como `Authorization: Bearer rvm_…`. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera. ````