---
title: "Creează cont gratuit pe email (10 credite pe lună)"
method: POST
path: "/api/v1/keys/register"
tags: ["Chei & cont"]
---

# Creează cont gratuit pe email (10 credite pe lună)

`POST /api/v1/keys/register`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/keys/register`
- Auth: none declared

Email NOU → cont gratuit + sesiune (201, cu token și cookie). Email DEJA înregistrat → NU se deschide sesiune: primești 200 cu `needsCode:true` și un cod pe email, pe care îl confirmi la POST /auth/email/verify. Adresa singură nu dă acces la un cont existent. Contul gratuit are 10 credite pe lună, fără card. Plafonul se reîmprospătează la începutul fiecărei luni, iar ce nu folosești nu se reportează. Verificarea emailului sau sign-in-ul Google nu schimbă plafonul. Cheia API `fk_…` se emite apoi cu POST /api/v1/keys/rotate.

## Request body

- object
  - `email` string, email, required
  - `label` string: numele agentului/aplicației (opțional)

## Response `201`

Cont creat / autentificat (cookie de sesiune setat).

- object
  - `ok` boolean
  - `loggedIn` boolean
  - `isNew` boolean

## Other responses

- `400`: Eroare — corp JSON { error, message } în limbaj natural.
- `429`: Eroare — corp JSON { error, message } în limbaj natural.

---

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