> ## Documentation Index > Fetch the complete documentation index at: https://api.housera.ro/llms.txt > Use this file to discover all available pages before exploring further. # Lista anunțurilor tale > Anunțurile contului (și ale agenției, dacă ești owner sau admin al ei), în orice stare, ordonate după ultima modificare, cu paginare prin cursor. Cu `fields` primești doar câmpurile cerute, de exemplu `code,external_ref,etag,updated_at` pentru reconciliere. ## OpenAPI ````yaml ro/openapi.json GET /account/listings openapi: 3.1.2 info: title: Housera API version: 1.0.0 description: >- Publică și gestionează anunțuri imobiliare pe Housera din CRM-ul sau din aplicația ta, cu aceleași reguli ca formularul Housera. servers: - url: https://staging.housera.ro/api/v1 description: 'Sandbox (staging): date de test, aceleași reguli ca producția.' - url: https://housera.ro/api/v1 description: 'Producție: anunțurile reale de pe housera.ro.' security: - bearer: [] tags: - name: Anunțurile tale - name: Poze - name: Evenimente - name: Vocabular paths: /account/listings: get: tags: - Anunțurile tale summary: Lista anunțurilor tale description: >- Anunțurile contului (și ale agenției, dacă ești owner sau admin al ei), în orice stare, ordonate după ultima modificare, cu paginare prin cursor. Cu `fields` primești doar câmpurile cerute, de exemplu `code,external_ref,etag,updated_at` pentru reconciliere. operationId: v1.account.listings.index parameters: - name: status in: query schema: anyOf: - $ref: '#/components/schemas/PropertyStatus' - type: 'null' description: >- Doar anunțurile în această stare (`pending`, `active`, `paused`, `sold`, `rejected`…). Fără el: toate. - name: per_page in: query schema: type: - integer - 'null' minimum: 1 maximum: 100 description: Câte rezultate pe pagină (implicit 50, maximum 100). responses: '200': content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/ListingApiResource' description: Rezultatul cererii. links: type: object properties: first: type: - string - 'null' description: Adresa primei pagini. last: type: - string - 'null' description: Adresa ultimei pagini (null la paginarea cu cursor). prev: type: - string - 'null' description: Adresa paginii anterioare, sau null. next: type: - string - 'null' description: >- Pagina următoare: adresa ei, sau cursorul de trimis mai departe. Null când nu mai e nimic. required: - first - last - prev - next description: Legăturile de paginare. meta: type: object properties: path: type: - string - 'null' description: Adresa de bază a listei. per_page: type: integer minimum: 0 description: Numărul de rezultate pe pagină. next_cursor: type: - string - 'null' description: >- Cursorul paginii următoare; null când lista s-a terminat. prev_cursor: type: - string - 'null' description: Cursorul paginii anterioare; null pe prima pagină. required: - path - per_page - next_cursor - prev_cursor description: Datele de paginare. required: - data - links - meta description: Reușit. '401': content: application/problem+json: schema: $ref: 2449e8cf-2469-4d15-b735-5241d23a2cba description: Cheia lipsește, e revocată sau a expirat (`unauthenticated`). '422': content: application/problem+json: schema: $ref: 23da4458-6a09-4e97-b93a-563e464e40c0 description: >- Datele nu trec regulile: câte o intrare pe câmp în `errors[]`, cu un `code` stabil. components: schemas: PropertyStatus: type: string enum: - draft - pending - active - rejected - paused - hidden - unconfirmed - sold title: PropertyStatus ListingApiResource: type: object properties: code: type: string description: >- Codul public al anunțului (8 caractere, ca în adresa lui de pe Housera). url: type: string description: Adresa anunțului pe Housera. type: type: - string - 'null' description: Tipul proprietății. subtype: type: - string - 'null' description: Subtipul. transaction: type: - string - 'null' description: Tipul tranzacției. title: type: - string - 'null' description: Titlul anunțului, în limba din `content_locale`. description: type: - string - 'null' description: Descrierea anunțului, în limba din `content_locale`. content_locale: type: - string - 'null' description: Limba titlului și a descrierii (ISO 639-1, de exemplu `ro`). price: type: - integer - 'null' description: >- Prețul în euro: valoarea pe care o compară căutarea. Ce acoperă spune `price_period`. currency: type: string const: EUR description: 'Moneda lui `price`: mereu `EUR`.' price_period: type: - string - 'null' enum: - total - month - night - null description: 'Ce cumpără prețul: `total` la vânzare, `month` la închiriere.' price_declared: type: - object - 'null' properties: amount: type: integer description: Suma. currency: type: string description: Moneda sumei, cod ISO 4217. required: - amount - currency description: Prețul exact cum l-a scris proprietarul anunțului, în moneda lui. reserved: type: boolean description: '`true`: un cumpărător l-a rezervat, dar anunțul e încă în ofertă.' negotiable: type: boolean description: Prețul negociabil. location: type: object properties: country: type: - string - 'null' description: Țara. county: type: - string - 'null' description: Județul. city: type: - string - 'null' description: Localitatea. area: type: - string - 'null' description: Zona sau cartierul. lat: type: - number - 'null' description: Latitudinea. lng: type: - number - 'null' description: Longitudinea. precision: type: string description: >- `exact`, sau `approximate` când punctul e rotunjit la ~100 m și strada e ascunsă. required: - country - county - city - area - lat - lng - precision description: Locul anunțului. facts: type: object additionalProperties: {} description: >- Caracteristicile anunțului: toate câmpurile care există pentru tipul și tranzacția lui, null cele nedeclarate. Codurile sunt cele din `/schema`. features: type: array items: type: string description: >- Dotările, ca coduri din catalogul de dotări (`features` din `/schema`). images: type: array items: type: string description: Adresele pozelor, în ordine. published_at: type: - string - 'null' description: Momentul publicării (ISO 8601). updated_at: type: - string - 'null' description: Ultima modificare (ISO 8601). attribution: type: object properties: lister: type: - string - 'null' description: >- Agenția, sau numele afișat al proprietarului, ca pe pagina anunțului. source: type: - string - 'null' description: >- Cheia sursei din care a fost preluat anunțul; null pentru cele postate direct pe Housera. source_label: type: - string - 'null' description: Numele sursei din care a fost preluat anunțul. source_external_id: type: - string - 'null' description: Id-ul anunțului la sursă. required: - lister - source - source_label - source_external_id description: Cine stă în spatele anunțului. required: - code - url - type - subtype - transaction - title - description - content_locale - price - currency - price_period - price_declared - reserved - negotiable - location - facts - features - images - published_at - updated_at - attribution title: ListingApiResource securitySchemes: bearer: type: http scheme: bearer description: 'Authorization: Bearer ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.