> Source: https://fiscal.link/integrators/docs/reference/cloud-management/activations
> Codul de activare al fiecărui client.

API Cloud: administrare

# Coduri de activare

Codul de activare al fiecărui client.

## Resursa GetIntegratorClientActivationResponse

`clientId` uuid doar citire

Id-ul clientului.

`clientName` string doar citire

Numele clientului.

`activationCode` string doar citire

Codul de activare, cu majuscule, în grupuri de câte 4. La introducere, liniuțele, spațiile și literele mici nu contează.

`activationLink` string doar citire

Linkul de activare. Codul stă în fragmentul adresei.

`registerCount` integer doar citire

Câte case nedezafectate are clientul.

`createdAtUtc` datetime doar citire

Când a fost creat codul, în UTC.

`rolledAtUtc` datetime poate fi null doar citire

Când a fost schimbat codul, în UTC. `null` până la prima schimbare.

### Obiecte folosite aici

-   [IntegratorClientListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-client-list-query)
-   [PaginatedResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-page)

## Rute

GET `…/activations`

### `list-activations`

Clienții cu codul și linkul de activare, paginat. Util în propriul tău flux de înrolare.

-   Cerere [IntegratorClientListQuery](https://fiscal.link/integrators/docs/reference/objects/cloud-client-list-query)
-   Răspuns [GetIntegratorClientActivationResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client-activation)
-   Răspuns [PaginatedResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-page)

GETCerere

```bash
curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/activations' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns

```json
{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}
```

GET `…/clients/{clientId}/activation`

### `get-client-activation`

Codul și linkul de activare ale unui client. Dacă clientul nu are cod, citirea îl creează.

-   Răspuns [GetIntegratorClientActivationResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client-activation)

GETCerere

```bash
curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12/activation' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns — get-client-activation, 200

```json
{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "activationCode": "3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "activationLink": "<activation-page>#code=3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "registerCount": 3,
  "createdAtUtc": "2026-08-27T09:14:22.512Z",
  "rolledAtUtc": null
}
```

POST `…/clients/{clientId}/activation/roll`

### `roll-client-activation`

Generează un cod nou. Cel vechi nu mai merge imediat; casele activate rămân conectate.

-   Răspuns [GetIntegratorClientActivationResponse](https://fiscal.link/integrators/docs/reference/objects/cloud-client-activation)

POSTCerere

```bash
curl -X POST 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12/activation/roll' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'
```

200Răspuns

```json
{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "activationCode": "3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "activationLink": "<activation-page>#code=3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "registerCount": 3,
  "createdAtUtc": "2026-08-27T09:14:22.512Z",
  "rolledAtUtc": null
}
```