---
title: "Contul curent: email, credite, firme urmărite"
method: GET
path: "/api/v1/me"
tags: ["Chei & cont"]
---

# Contul curent: email, credite, firme urmărite

`GET /api/v1/me`

## Request

- Base URL: `https://firmoscop.ro`
- URL: `https://firmoscop.ro/api/v1/me`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `fs_session`

## Response `200`

Starea contului.

- object
  - `email` string, nullable
  - `credits` integer: Cât mai poate consuma contul acum: plafonul lunar rămas + soldul care nu expiră.
  - `creditStatus` object: Desfacerea lui `credits`. O operație consumă întâi din plafonul lunii, apoi din sold; 402 doar când sunt goale amândouă.
    - `remaining` integer
    - `plan` object: Plafonul planului în luna UTC curentă; se reface la începutul lunii.
      - `limit` integer
      - `used` integer
      - `remaining` integer
    - `topup` integer: Soldul: credite din pachete cumpărate sau adăugate manual. Nu expiră și nu se resetează lunar.
  - `watching` integer
  - `watchLimit` integer, nullable: Plafonul listei de urmărire al contului: 25 pe contul gratuit; null = cont fără plafon.

## Other responses

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

## Changes

- **2026-10-19** `1589e76b6765`: 1 info
  - added the optional property `creditStatus` to the response with the `200` status

[Operation history](https://skmtc.dev/firmoscop/apis/firmoscop-api/changes/api/v1/me/get.md)

---

[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)