---
title: "Listare cote TVA"
method: GET
path: "/v3/companies/{cif}/vat-rates"
tags: ["Cote TVA"]
---

# Listare cote TVA

`GET /v3/companies/{cif}/vat-rates`

## Request

- Base URL: `https://ws.smartbill.ro/SBORO/api`
- URL: `https://ws.smartbill.ro/SBORO/api/v3/companies/{cif}/vat-rates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smartbill/apis/smartbill-api/docs/v3/companies/:cif/vat-rates/get.ts> (a function with typed inputs; its response is checked against the schema)

Returneaza cotele de TVA din nomenclatorul tau SmartBill.

**Relatia cu V1**

Este acelasi nomenclator ca [Cote TVA](#api-1/tag/configurari/GET/tax) din V1: `name` si `percentage` au aceleasi valori. Aici primesti in plus `id`, `isReverseCharge` si `reverseChargePercentage`.

Ce trimiti mai departe depinde de document. Facturile, proformele si incasarile V1 primesc `taxName` si `taxPercentage`. [NIR-urile](#api-1/tag/nir-uri-beta) V3 identifica cota prin `id`. Endpointul acesta acopera ambele cazuri; `/tax` doar pe primul.

**Id-uri**

Cotele nu pot fi modificate din SmartBill Cloud, doar create si sterse, deci un `id` pastreaza acelasi `name` si acelasi `percentage` cat timp exista. O schimbare de procent inseamna o cota noua, cu id nou. O cota stearsa dispare imediat din listare, iar `GET .../{id}` intoarce `404 vat_rate_not_found` - trateaza situatia ca normala, nu ca eroare de integrare. Id-urile sunt per firma: un id valid pe o firma intoarce `404` pe alta.

**Taxare inversa**

Cotele cu taxare inversa au `isReverseCharge` `true` si `percentage` `0`, iar procentul lor de referinta se afla in `reverseChargePercentage`. Filtrul `percentage` se aplica doar campului `percentage`, deci `?percentage=21` nu returneaza o cota cu taxare inversa al carei `reverseChargePercentage` este `21`. Toate cotele cu taxare inversa apar la `?percentage=0`.

**Filtrare**

`name` potriveste oriunde in nume, nu doar la inceput: `?name=norm` gaseste si `Normala`, si `Normala2`. Potrivirea ignora literele mari si spatiile de la capetele valorii trimise. `percentage` potriveste exact valoarea, deci `?percentage=21`, `?percentage=21.0` si `?percentage=21.0000` dau acelasi rezultat, iar `?percentage=2` nu gaseste cota de 21%. Un filtru trimis gol (`?name=` sau `?percentage=`) e ignorat, deci primesti lista nefiltrata. Trimise impreuna, cele doua filtre se aplica simultan.

## Path parameters

- `cif` string, required

## Query parameters

- `name` string
- `percentage` number
- `limit` integer
- `after` string
- `before` string

## Response `200`

Lista cote TVA paginata (paginare cursor)

- object
  - `items` VatRateV3[]
    - `id` string: ID unic cota de TVA
    - `name` string: Denumirea cotei asa cum a fost introdusa in nomenclator. Text liber, nu e unic pe firma.
    - `percentage` number: Procentul care se trece pe document si care se trimite ca `taxPercentage` la emiterea documentelor V1. La cotele cu taxare inversa este `0`. Serializat cu 4 zecimale (`21.0000`).
    - `isReverseCharge` boolean: Cota se aplica prin taxare inversa
    - `reverseChargePercentage` number: Procentul de referinta al cotei cu taxare inversa, informativ. Nu se trimite ca `taxPercentage` - pe document merge `percentage`, adica `0`. Este `0` cand `isReverseCharge` este `false`. Serializat cu 4 zecimale.
  - `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
- `404`: Cursor de paginare inexistent
- `405`: Metoda HTTP nepermisa
- `406`: Format neacceptat (Accept header invalid)

## Changes

- **2026-09-18** `570149c0edde`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartbill/apis/smartbill-api/changes/v3/companies/:cif/vat-rates/get.md)

---

[API](https://skmtc.dev/smartbill/apis/smartbill-api.md) - [All operations](https://skmtc.dev/smartbill/apis/smartbill-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartbill/apis/smartbill-api/revisions/b79a53e24b9d?raw)