> ## Documentation Index > Fetch the complete documentation index at: https://developers.thinkout.io/llms.txt > Use this file to discover all available pages before exploring further. # Listează etichetele > Întoarce etichetele ordonate după `name`, apoi după `id`. Nu există filtre. Fiecare etichetă își poartă tipul, așa că un apelant care vrea etichetele grupate pe tipuri grupează pagina pe care o are deja. ## OpenAPI ````yaml /openapi/v1.ro.yaml get /labels openapi: 3.1.0 info: title: ThinkOut API version: '1.0' description: >- Acces programatic la datele unui spațiu de lucru ThinkOut. În versiunea 1 fiecare endpoint este un `GET`. Listele folosesc același înveliș de răspuns și se paginează cu un cursor oriunde lista poate crește. Versiunea 1 se schimbă doar prin adăugare. Pot apărea oricând endpointuri noi, parametri opționali noi, câmpuri noi în răspuns și valori noi de enumerare, așa că tolerați câmpurile necunoscute și nu tratați niciodată o enumerare ca pe o mulțime închisă. contact: name: Suport ThinkOut url: https://developers.thinkout.io/guides/support servers: - url: https://api.thinkout.io/v1 security: - apiKey: [] tags: - name: Bănci description: Conexiunile bancare ale spațiului de lucru și starea fiecăreia. - name: Conturi description: Conturi manuale, sincronizate cu banca și delegate, cu solduri calculate. - name: Tranzacții description: Mișcări înregistrate și în așteptare pe conturile spațiului de lucru. - name: Categorii description: Arborele de categorii al spațiului de lucru, pe direcție și activitate. - name: Parteneri description: >- Clienții și furnizorii cărora le sunt atribuite tranzacțiile și previziunile. - name: Etichete description: Etichete libere, grupate pe tipuri. - name: Previziuni description: Încasări și plăți planificate și tranzacțiile care le-au realizat. - name: Rapoarte description: >- Totaluri, nu rânduri. Sinteze peste tranzacții și previziuni, plus rapoartele de cash flow salvate în spațiul de lucru. paths: /labels: get: tags: - Etichete summary: Listează etichetele description: >- Întoarce etichetele ordonate după `name`, apoi după `id`. Nu există filtre. Fiecare etichetă își poartă tipul, așa că un apelant care vrea etichetele grupate pe tipuri grupează pagina pe care o are deja. operationId: listLabels parameters: - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/cursor' responses: '200': description: O pagină de etichete. content: application/json: schema: allOf: - $ref: '#/components/schemas/List' - type: object properties: data: type: array items: $ref: '#/components/schemas/Label' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: parameters: limit: name: limit in: query description: Dimensiunea paginii. schema: type: integer minimum: 1 maximum: 500 default: 100 cursor: name: cursor in: query description: Token opac din `next_cursor` al paginii anterioare. schema: type: string schemas: List: type: object required: - object - data - has_more - next_cursor properties: object: type: string const: list data: type: array items: {} has_more: type: boolean description: Dacă mai există o pagină. next_cursor: type: - string - 'null' description: >- Trimite-l ca `cursor` pentru pagina următoare. `null` pe ultima pagină. Label: type: object required: - object - id - name - type - color - created_at - updated_at properties: object: type: string const: label id: type: string format: uuid name: type: string example: Q3 type: oneOf: - $ref: '#/components/schemas/LabelType' - type: 'null' description: >- Grupul din care face parte eticheta, sau `null` când nu are niciunul. Un tip apare odată cu prima etichetă care îl folosește și dispare odată cu ultima, așa că nu are endpoint propriu. color: type: - string - 'null' pattern: ^#[0-9a-f]{6}$ created_at: type: string format: date-time updated_at: type: string format: date-time example: object: label id: 1f2e3d4c-5b6a-4978-8877-665544332211 name: Q3 type: id: 7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f name: Quarter color: '#7c3aed' created_at: '2026-01-05T09:00:00Z' updated_at: '2026-01-05T09:00:00Z' LabelType: type: object required: - id - name properties: id: type: string format: uuid name: type: string example: Quarter Error: type: object required: - error properties: error: type: object required: - type - code - message - param - request_id properties: type: type: string enum: - invalid_request - authentication - not_found - rate_limit - server code: type: string description: >- Motiv stabil, citibil de o mașină. Ramifică pe acesta, nu pe `message`. Codurile specifice rapoartelor sunt `too_many_groups`, `period_too_long`, `as_of_in_future` și `invalid_expand`. message: type: string description: >- Explicație pentru oameni, în engleză. Formularea se poate schimba. param: type: - string - 'null' description: Parametrul de query sau de cale vinovat, când există unul. request_id: type: string description: Menționează-l când contactezi suportul. responses: BadRequest: description: Un parametru este invalid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request code: invalid_parameter message: Parameter 'from' must be a date in YYYY-MM-DD format. param: from request_id: req_01J8ZT4Q7Y6M3K Unauthorized: description: Cheia API lipsește, este necunoscută sau revocată. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication code: unauthorized message: Invalid API key. param: null request_id: req_01J8ZT4Q7Y6M3K RateLimited: description: Prea multe cereri. Așteaptă numărul de secunde din `Retry-After`. headers: Retry-After: schema: type: integer description: Secunde de așteptat înainte de a reîncerca. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limit code: rate_limited message: Rate limit exceeded. Retry after 12 seconds. param: null request_id: req_01J8ZT4Q7Y6M3K securitySchemes: apiKey: type: http scheme: bearer description: >- O cheie API creată în setările ThinkOut. O cheie citește un singur spațiu de lucru. ````