> ## Documentation Index > Fetch the complete documentation index at: https://docs.nox.energy/llms.txt > Use this file to discover all available pages before exploring further. # Get Households Telemetry Current > **Preview: not available yet.** This endpoint is documented ahead of its release and currently answers `501 Not Implemented`. Its contract may still change before release. Get the latest telemetry of your households, in kW. * `house_load_kw` is everything the household consumes except the battery. * `grid_power_kw` follows the consumption sign convention used by all power fields of the API: positive when the household imports from the grid, negative when it exports. It is `null` when the household has no grid metering (see `grid_metering` in `GET /v1/households`). ## OpenAPI ````yaml /api-docs/household/openapi-household.json get /v1/households/telemetry/current openapi: 3.1.0 info: title: NOX Energy API - Household description: > # Household API Documentation This documentation shows only the household endpoints: the households of your users, the NOX-connected devices in them and the optimization settings they share. **Preview:** these endpoints are documented ahead of their release and currently answer `501 Not Implemented`. ## Authentication 1. Get your API key from [NOX Energy](mailto:support@nox.energy). 2. Include the API key in your API calls with the header: `x-api-key: YOUR_API_KEY`. Base URL: [https://api.nox.energy](https://api.nox.energy) version: 1.0.0 servers: - url: https://api.nox.energy description: Production Server security: - ApiKeyAuth: [] tags: - name: Asset Info description: API to get basic information about your assets. paths: /v1/households/telemetry/current: get: tags: - Asset Info summary: Get Households Telemetry Current description: >- **Preview: not available yet.** This endpoint is documented ahead of its release and currently answers `501 Not Implemented`. Its contract may still change before release. Get the latest telemetry of your households, in kW. * `house_load_kw` is everything the household consumes except the battery. * `grid_power_kw` follows the consumption sign convention used by all power fields of the API: positive when the household imports from the grid, negative when it exports. It is `null` when the household has no grid metering (see `grid_metering` in `GET /v1/households`). operationId: get_households_telemetry_current_v1_households_telemetry_current_get parameters: - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: > The maximum number of items to return per page of results. This should be used together with the `next_token` parameter to paginate through results. Read the pagination parameter documentation for more details. default: 1000 title: Limit description: > The maximum number of items to return per page of results. This should be used together with the `next_token` parameter to paginate through results. Read the pagination parameter documentation for more details. - name: next_token in: query required: false schema: anyOf: - type: string - type: 'null' description: > The `next_token` is a token used to retrieve the next page of results when there are more results than can fit in a single page(=API response). By default, the API will return a `next_token` of the first page if no token was given as a parameter. If the token is `null` you have reached the end of the results. This should be used together with the `limit` parameter to paginate through results. To get all results of your call, you can keep calling the same API call with the previously returned `next_token` until it returns `null`. title: Next Token description: > The `next_token` is a token used to retrieve the next page of results when there are more results than can fit in a single page(=API response). By default, the API will return a `next_token` of the first page if no token was given as a parameter. If the token is `null` you have reached the end of the results. This should be used together with the `limit` parameter to paginate through results. To get all results of your call, you can keep calling the same API call with the previously returned `next_token` until it returns `null`. - name: household_id in: query required: false schema: anyOf: - type: string - type: 'null' description: > The ID of the household to filter on. If not provided, all households are returned. title: Household Id description: > The ID of the household to filter on. If not provided, all households are returned. - name: user_id in: query required: false schema: anyOf: - type: string - type: 'null' description: > Your own ID of the user to filter on: the ID you use internally for this user, whether you are an energy supplier, an OEM or another partner. If not provided, all users are returned. title: User Id description: > Your own ID of the user to filter on: the ID you use internally for this user, whether you are an energy supplier, an OEM or another partner. If not provided, all users are returned. responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/HouseholdTelemetryCurrentResponse' example: data: - household_id: 8f14e45f-ceea-467a-9575-6c1b1f1e7c2a measured_at: '2026-10-17T12:03:00Z' house_load_kw: 2.8 grid_power_kw: 2.8 meta: energy_supplier: Energy Supplier A '403': description: Your API key has no access to the battery features content: application/json: example: detail: Energy Supplier A is not authorized to access this feature. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '501': description: Not implemented yet content: application/json: example: detail: This endpoint is not available yet. components: schemas: HouseholdTelemetryCurrentResponse: properties: data: anyOf: - items: $ref: '#/components/schemas/HouseholdTelemetryCurrent' type: array - type: 'null' title: Data description: List of household telemetry meta: anyOf: - $ref: '#/components/schemas/HouseholdTelemetryCurrentMeta' - type: 'null' description: Response metadata type: object title: HouseholdTelemetryCurrentResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError HouseholdTelemetryCurrent: properties: household_id: anyOf: - type: string - type: 'null' title: Household Id description: Unique household identifier measured_at: anyOf: - type: string - type: 'null' title: Measured At description: ISO 8601 UTC timestamp of the measurement house_load_kw: anyOf: - type: number - type: 'null' title: House Load Kw description: >- Current house load in kW: everything the household consumes except the battery grid_power_kw: anyOf: - type: number - type: 'null' title: Grid Power Kw description: >- Current grid power in kW. Positive when the household imports from the grid, negative when it exports. `null` if the household has no grid metering. type: object title: HouseholdTelemetryCurrent HouseholdTelemetryCurrentMeta: properties: energy_supplier: anyOf: - type: string - type: 'null' title: Energy Supplier description: Energy supplier name next_token: anyOf: - type: string - type: 'null' title: Next Token description: Token for pagination type: object title: HouseholdTelemetryCurrentMeta ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: 'API Key authentication. Enter your API key in the format: YOUR_API_KEY' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.