> ## 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. # Un anunț al tău > Anunțul, cu starea, moderarea și `etag`-ul pe care îl trimiți înapoi în `If-Match`. ## OpenAPI ````yaml ro/openapi.json GET /account/listings/{code} 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/{code}: get: tags: - Anunțurile tale summary: Un anunț al tău description: >- Anunțul, cu starea, moderarea și `etag`-ul pe care îl trimiți înapoi în `If-Match`. operationId: v1.account.listings.show parameters: - name: code in: path required: true schema: type: string description: >- Codul public al anunțului (8 caractere, ca în adresa lui de pe Housera). responses: '200': content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AccountListingApiResource' description: Rezultatul cererii. warnings: type: array items: anyOf: - type: object properties: pointer: type: string description: >- Câmpul la care se referă, ca JSON Pointer (`/features/2`). code: type: string description: >- Motivul, ca cod stabil: `not_for_type`, `not_for_transaction` sau `unknown_feature`. required: - pointer - code - type: object properties: pointer: type: string description: >- Câmpul la care se referă, ca JSON Pointer (`/features/2`). code: anyOf: - type: string - type: string enum: - unknown_feature description: >- Motivul, ca cod stabil: `not_for_type`, `not_for_transaction` sau `unknown_feature`. required: - pointer - code description: >- Ce s-a ignorat din cerere, fără să o refuze (un câmp care nu există pentru tipul și tranzacția anunțului, o dotare necunoscută). Cererea a reușit; verifică-ți maparea. required: - data - warnings 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`). '404': content: application/problem+json: schema: $ref: 2449e8cf-2469-4d15-b735-5241d23a2cba description: Anunțul nu există sau nu e al contului tău (`not_found`). components: schemas: AccountListingApiResource: type: object title: AccountListingApiResource 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. external_ref: type: - string - 'null' description: >- Id-ul anunțului în sistemul tău, dacă l-ai creat cu `PUT /listings/ref/{ref}`. status: $ref: '#/components/schemas/PropertyStatus' description: >- Starea anunțului: `pending` (la moderare), `active` (public), `paused` (oprit de tine), `sold`, `rejected`, `hidden` (scos de moderator) sau `unconfirmed` (disponibilitatea n-a fost confirmată la termen; o confirmi din cont și revine). moderation: type: object properties: edit_pending: type: boolean description: >- `true`: o editare așteaptă moderarea; anunțul public arată încă versiunea aprobată. rejection_reason: type: - string - 'null' description: >- Motivul respingerii, în limba cererii. Null dacă anunțul nu e respins. rejection_codes: type: array items: type: string description: Motivele respingerii, ca coduri stabile. description: Starea moderării anunțului. media: type: object properties: processing: type: boolean description: '`true`: pozele trimise sunt încă procesate.' description: Starea pozelor. etag: type: string description: >- Versiunea anunțului. O trimiți în `If-Match` la editare, ca să nu suprascrii o modificare făcută între timp. 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 - external_ref - status - moderation - media - etag PropertyStatus: type: string enum: - draft - pending - active - rejected - paused - hidden - unconfirmed - sold title: PropertyStatus securitySchemes: bearer: type: http scheme: bearer description: 'Authorization: Bearer ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.