# Ricerca Cliente

## Cliente / GetBy

L’endpoint **Cliente/GetBy** consente di interrogare il gestionale **SoluzionaCore** per ottenere i dati di un cliente specifico o di un elenco di clienti.

---

## Tipo di chiamata

La chiamata è di tipo **GET** e prevede l’utilizzo di **query parameter** per specificare il criterio di ricerca.

---

## Parametri di ricerca

Il cliente può essere ricercato utilizzando uno dei seguenti parametri:

- **id**
- **codice fiscale**
- **partita IVA**
- **codice tessera**
- **codice 1**
- **codice 2**

---

## Documentazione dell’endpoint

La documentazione completa della chiamata è disponibile al seguente indirizzo:

<p class="callout info">[https://soluzionacoreapi.soluziona.cloud/scalar/#tag/cliente/get/apiclientegetby](https://soluzionacoreapi.soluziona.cloud/scalar/#tag/cliente/get/apiclientegetby)</p>

---

## Parametro ConAnagrafica

L’endpoint prevede il parametro opzionale **ConAnagrafica**:

- **false** (valore di default):  
    restituisce esclusivamente l’oggetto **Cliente** di primo livello.
- **true**:  
    restituisce l’anagrafica completa del cliente, includendo i seguenti oggetti:
    
    
    - **Anagrafica**
    - **Comune**
    - **Provincia**
    - **Regione**
    - **Nazione**

> **Nota**  
> L’utilizzo del parametro `ConAnagrafica=true` è consigliato quando è necessario disporre di tutte le informazioni anagrafiche complete del cliente in un’unica chiamata.

---

## Parametri Size e Offset

L’endpoint supporta i parametri opzionali **Size** e **Offset** per la gestione della paginazione dei risultati.

- **Size** (default: `20`)  
    Indica il numero di record da restituire.
- **Offset** (default: `0`)  
    Indica il numero di record da saltare dall’inizio del risultato, permettendo di recuperare i successivi.