> ## 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. # A listing of yours > The listing, with the state, moderation and `etag` you return in `If-Match`. ## OpenAPI ````yaml en/openapi.json GET /account/listings/{code} openapi: 3.1.2 info: title: Housera API version: 1.0.0 description: >- Publish and manage real estate listings on Housera from your CRM or application, with the same rules as the Housera form. servers: - url: https://staging.housera.ro/api/v1 description: 'Sandbox (staging): test data, the same rules as production.' - url: https://housera.ro/api/v1 description: 'Production: real listings from housera.ro.' security: - bearer: [] tags: - name: Your Listings - name: Photos - name: Events - name: Vocabulary paths: /account/listings/{code}: get: tags: - Your Listings summary: A listing of yours description: >- The listing, with the state, moderation and `etag` you return in `If-Match`. operationId: v1.account.listings.show parameters: - name: code in: path required: true schema: type: string description: >- The public code of the listing (8 characters, as in its address on Housera). responses: '200': content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AccountListingApiResource' description: The result of the request. warnings: type: array items: anyOf: - type: object properties: pointer: type: string description: >- The field to which it refers, as JSON Pointer (`/features/2`). code: type: string description: >- The reason, as stable code: `not_for_type`, `not_for_transaction` or `unknown_feature`. required: - pointer - code - type: object properties: pointer: type: string description: >- The field to which it refers, as JSON Pointer (`/features/2`). code: anyOf: - type: string - type: string enum: - unknown_feature description: >- The reason, as stable code: `not_for_type`, `not_for_transaction` or `unknown_feature`. required: - pointer - code description: >- What was ignored from the request, without rejecting it (a field that does not exist for the listing's type and transaction, an unknown amenity). The request succeeded; check your mapping. required: - data - warnings description: Successful. '401': content: application/problem+json: schema: $ref: df9e5864-a2f9-487d-b0db-169bf3dc8506 description: The key is missing, revoked, or expired (`unauthenticated`). '404': content: application/problem+json: schema: $ref: df9e5864-a2f9-487d-b0db-169bf3dc8506 description: The listing does not exist or it is not your account (`not_found`). components: schemas: AccountListingApiResource: type: object title: AccountListingApiResource properties: code: type: string description: >- The public code of the listing (8 characters, as in its address on Housera). url: type: string description: The address of the listing on Housera. type: type: - string - 'null' description: Property type. subtype: type: - string - 'null' description: Subtype. transaction: type: - string - 'null' description: Transaction type. title: type: - string - 'null' description: The title of the listing, in the language of `content_locale`. description: type: - string - 'null' description: The description of the listing, in the language of `content_locale`. content_locale: type: - string - 'null' description: The language of the title and description (ISO 639-1, e.g. `ro`). price: type: - integer - 'null' description: >- Price in euros: the value search compares. `price_period` says what it covers. currency: type: string const: EUR description: 'The currency of `price`: always `EUR`.' price_period: type: - string - 'null' enum: - total - month - night - null description: 'What the price buys: `total` for sale, `month` for rent.' price_declared: type: - object - 'null' properties: amount: type: integer description: The amount. currency: type: string description: The currency of the amount, ISO 4217 code. required: - amount - currency description: >- The price exactly as written by the owner of the listing, in its currency. reserved: type: boolean description: '`true`: a buyer has reserved it, but the listing is still on offer.' negotiable: type: boolean description: Negotiable price. location: type: object properties: country: type: - string - 'null' description: Country. county: type: - string - 'null' description: County. city: type: - string - 'null' description: City. area: type: - string - 'null' description: The neighbourhood or area. lat: type: - number - 'null' description: Latitude. lng: type: - number - 'null' description: Longitude. precision: type: string description: >- `exact`, or `approximate` when the point is rounded to ~100 m and the street is hidden. required: - country - county - city - area - lat - lng - precision description: The location of the listing. facts: type: object additionalProperties: {} description: >- The characteristics of the listing: all fields that exist for its type and transaction, null if undeclared. The codes are from `/schema`. features: type: array items: type: string description: >- Features, as codes from the amenities catalog (`features` of `/schema`). images: type: array items: type: string description: The addresses of the photos, in order. published_at: type: - string - 'null' description: The publication time (ISO 8601). updated_at: type: - string - 'null' description: The last modification (ISO 8601). attribution: type: object properties: lister: type: - string - 'null' description: >- The agency, or the displayed name of the owner, as on the listing page. source: type: - string - 'null' description: >- The key of the source from which the listing was obtained; null for those posted directly on Housera. source_label: type: - string - 'null' description: The name of the source from which the listing was taken. source_external_id: type: - string - 'null' description: The listing ID at the source. required: - lister - source - source_label - source_external_id description: Who is behind the listing. external_ref: type: - string - 'null' description: >- The listing ID in your system, if you created it with `PUT /listings/ref/{ref}`. status: $ref: '#/components/schemas/PropertyStatus' description: >- The status of the listing: `pending` (in moderation), `active` (public), `paused` (paused by you), `sold`, `rejected`, `hidden` (removed by a moderator) or `unconfirmed` (availability was not confirmed in time; confirm it from your account and the listing comes back). moderation: type: object properties: edit_pending: type: boolean description: >- `true`: an edit is awaiting moderation; the public listing still shows the approved version. rejection_reason: type: - string - 'null' description: >- The reason for rejection, in the request language. Null if the listing is not rejected. rejection_codes: type: array items: type: string description: Reasons for rejection, as stable codes. description: The moderation status of the listing. media: type: object properties: processing: type: boolean description: '`true`: the submitted photos are still being processed.' description: The status of the photos. etag: type: string description: >- The version of the listing. You send it in `If-Match` when editing, so you don't overwrite a change made in the meantime. 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.