---
title: "Obtener un cliente por ID"
method: GET
path: "/clients/{id}"
tags: ["Clientes"]
---

# Obtener un cliente por ID

`GET /clients/{id}`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/clients/{id}`
- Auth: HTTP bearer

Devuelve el detalle completo de un cliente específico del negocio actual.

**Autenticación requerida:** Este endpoint requiere autenticación Bearer Token.
Usar el campo `tokenCurrent` obtenido del servicio de login (/login) en el header:
`Authorization: Bearer {tokenCurrent}`

**Permiso requerido:** `CL_POST` (Crear/Editar)

**Comportamiento:**
- El cliente debe pertenecer al negocio autenticado.
- Si el negocio tiene configurado compartir clientes con el negocio padre, también se busca en el negocio padre.
- Retorna `null` si el cliente no existe (sin error 404).

## Ejemplo de Uso

```
GET /clients/507f1f77bcf86cd799439021
Authorization: Bearer tu_token_aqui
```

## Path parameters

- `id` string, required

## Response `200`

Cliente encontrado exitosamente

- Client
  - `_id` string: ID único del cliente
  - `business` string: ID del negocio al que pertenece el cliente
  - `isSocialReason` boolean: Indica si es una razón social (empresa)
  - `responsibilities` string: Responsabilidades tributarias
  - `responsibilityName` string: Nombre de la responsabilidad tributaria
  - `name` string: Nombre del cliente
  - `lastName` string: Apellido del cliente
  - `idDocumentType` number: Tipo de documento de identidad
  - `documentName` string: Nombre del tipo de documento
  - `document` string: Número de documento
  - `checkDigit` number: Dígito verificador del documento
  - `isVATCompanyType` boolean: Indica si es una empresa con IVA
  - `email` string, email: Correo electrónico del cliente
  - `phone` string: Número de teléfono del cliente
  - `address` string: Dirección del cliente
  - `cityDetail` object: Detalles de la ciudad
    - `countryCode` string: Código del país
    - `stateCode` string: Código del departamento
    - `stateName` string: Nombre del departamento
    - `cityCode` string: Código de la ciudad
    - `cityName` string: Nombre de la ciudad
  - `city` string: Ciudad del cliente (deprecado)
  - `postalCode` string: Código postal
  - `notes` string: Notas adicionales sobre el cliente
  - `deleted` boolean: Indica si el cliente está eliminado
  - `deletedInfo` object: Información de eliminación
    - `isDeleted` boolean: Indica si está eliminado
    - `deletedBy` string: Usuario que eliminó el cliente
    - `date` string, date-time: Fecha de eliminación
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación
  - `birthdate` string, date: Fecha de nacimiento del cliente
  - `points` number: Puntos de fidelidad del cliente
  - `creditMovement` object[]: Historial de movimientos de crédito
    - `paymentMethod` object
      - `internalId` string: ID del método de pago
      - `name` string: Nombre del método de pago
    - `date` string, date-time: Fecha del movimiento
    - `total` number: Monto del movimiento
    - `notes` string: Notas del movimiento

## Other responses

- `401`: Token de autorización inválido o faltante
- `403`: Sin permisos para consultar clientes
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)