> ## Documentation Index
> Fetch the complete documentation index at: https://hellasdirect.ask-wire.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Census 2021

> Retrieve a Census 2021 record for a specific building, identified by geographical code and building block.

## Overview

Returns Census 2021 data for a building identified by its geographical code and building block number. The response is a flat JSON object containing every field of the matched record — the exact shape depends on the requested dataset.

Authentication is not enforced at the schema level, but a valid Bearer token is recommended for production integrations.

***

## Path parameters

| Parameter | Type   | Required | Description                                                                               |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------- |
| `dataset` | string | Yes      | Census 2021 dataset to query. Currently only `building_and_characteristics` is supported. |

***

## Query parameters

| Parameter           | Type   | Required | Description                                                         |
| ------------------- | ------ | -------- | ------------------------------------------------------------------- |
| `geographical_code` | string | Yes      | Geographical code identifying the area (e.g. quarter/village code). |
| `building_block`    | string | Yes      | Building block number within the geographical area.                 |

***

## Response

Returns a flat JSON object. Every field of the matched Census 2021 record is included. The exact fields depend on the requested dataset.

***

## Example request

```bash theme={null}
curl -X GET "https://pandora.ask-wire.com/api/census2021/building_and_characteristics?geographical_code=0123&building_block=045" \
  -H "Authorization: Bearer YOUR_TOKEN"
```


## OpenAPI

````yaml GET /api/census2021/{dataset}
openapi: 3.1.0
info:
  title: Properties API
  version: 1.0.0
  description: Public properties and foreclosure listings API
servers:
  - url: https://pandora.ask-wire.com
    description: Main API (Properties)
  - url: https://zeus.ask-wire.com
    description: Auth API
security:
  - bearerAuth: []
paths:
  /api/census2021/{dataset}:
    get:
      summary: Query Census 2021
      description: >-
        Retrieves a Census 2021 record for a specific building, identified by
        geographical code and building block. Authentication is not enforced at
        the schema level but a valid Bearer token is recommended for production
        integrations.
      operationId: getCensus2021
      parameters:
        - name: dataset
          in: path
          required: true
          description: >-
            Census 2021 dataset to query. Currently only
            `building_and_characteristics` is supported.
          schema:
            type: string
            enum:
              - building_and_characteristics
        - name: geographical_code
          in: query
          required: true
          description: Geographical code identifying the area (e.g. quarter/village code).
          schema:
            type: string
        - name: building_block
          in: query
          required: true
          description: Building block number within the geographical area.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Every field of the matched record is returned as a flat JSON object.
            Response shape depends on the requested dataset.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````