---
title: "Listare clienti"
method: GET
path: "/v3/companies/{cif}/clients"
tags: ["Clienti"]
---

# Listare clienti

`GET /v3/companies/{cif}/clients`

Returneaza toti clientii din nomenclatorul tau SmartBill.

**Filtrare**

`name` potriveste oriunde in nume, nu doar la inceput: `?name=lpha` gaseste `Client Alpha SRL`.

`vatCode` nu normalizeaza prefixul: un client salvat cu `RO55555555` nu e gasit de `?vatCode=55555555`. Trimite valoarea exact cum e salvata.

Filtrele se combina cu AND: `?name=Alpha&code=INEXISTENT` intoarce 0 rezultate. Un filtru trimis gol (`?name=`) e ignorat, deci primesti lista nefiltrata.

## Path parameters

- `cif` string, required

## Query parameters

- `name` string
- `code` string
- `vatCode` string
- `limit` integer
- `after` string
- `before` string

## Response `200`

Lista clienti paginata (paginare cursor)

- object
  - `items` ClientV3[]
    - `id` string — ID unic client
    - `name` string
    - `vatCode` string
    - `regCom` string
    - `code` string
    - `address` string
    - `city` string
    - `county` string
    - `country` string
    - `bank` string
    - `iban` string
    - `email` string, email
    - `contact` string
    - `phone` string
    - `isVatPayer` boolean
    - `brand` string — Brand asociat
    - `deliveryAddresses` DeliveryAddressV3[] — Adrese de livrare
      - `description` string
      - `address` string
      - `addressAdditionalInfo` string
      - `addressLine3` string
      - `city` string
      - `county` string
      - `country` string
      - `zipCode` string
      - `defaultAddress` boolean — Adresa implicita de livrare
  - `pagination` object
    - `next` string, nullable — URL-ul complet catre pagina urmatoare, sau null daca nu mai exista pagini
    - `previous` string, nullable — URL-ul complet catre pagina anterioara, sau null daca esti pe prima pagina

## Other responses

- `400` — Parametri de paginare sau filtrare invalizi
- `401` — Autentificare esuata
- `403` — Permisiuni insuficiente
- `405` — Metoda HTTP nepermisa
- `406` — Format neacceptat (Accept header invalid)

---

[API](https://skmtc.dev/smartbill/apis/smartbill-api.md) · [All operations](https://skmtc.dev/smartbill/apis/smartbill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartbill/smartbill-api/revisions/29940a27d41c/schema)