> ## Documentation Index > Fetch the complete documentation index at: https://docs.kodelabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Get point priority array > Returns the priority levels that currently hold a value on a point, read live from the data source. A writable point on a building automation system can hold a value at several priority levels. The lowest level number has the highest priority. To see which level is in effect, use [Get point write state](https://docs.kodelabs.com/products/kode-api/api-reference/points/get-point-write-state.md). KODE OS reads the levels from the data source on each request, so the response reflects the point now. A slow or unreachable data source makes the request slow or makes it fail. The response lists only the levels the data source reports, lowest level first. A level that is not listed holds no value. The level range depends on the connector, for example `0` to `15` or `1` to `16`. The response is `200` with an empty array when: * The point is not writable. * The point's connector cannot write to points, or has been deleted. * The connector does not keep a priority array for the point. * No level holds a value. This endpoint only reads. It does not write a value or release a level. ## OpenAPI ````yaml /openapi/kode-api.yaml get /api/v1/buildings/{buildingId}/integrations/points/{pointId}/priority-array openapi: 3.1.0 info: title: KODE API version: 1.0.0 summary: Programmatic access to KODE OS resources and operations. description: > Use the KODE API to work with buildings, data sources, connectors, devices, points, virtual devices, timeseries data, schedules, the ontology, templating, mass writes, spaces, space assignments, tenants, meters, users, actions, and AssetOps work orders. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.kodelabs.com/kodeos description: KODE API security: - bearerAuth: [] tags: - name: Authentication description: OAuth 2.0 discovery, token, and revocation endpoints. - name: Buildings description: Buildings and their areas. - name: Data sources description: Data sources connected to a building. - name: Devices description: Devices and their points. - name: Points description: Point queries and point writes. - name: Timeseries description: Current and historical point values. - name: Actions description: Actions exposed by building data sources. - name: Work orders description: AssetOps work orders, lookups, comments, and attachments. - name: Connectors description: KODE API connectors and the devices and points ingested through them. - name: Schedules description: Schedules discovered on building data sources. - name: Templating description: Apply ontology templates to groups of points. - name: Virtual devices description: Virtual devices that group points from other devices. - name: Ontology description: Canonical types, fields, units, and connections of the KODE ontology. - name: Users description: Users of the organization and their app access. - name: Mass write description: Write values to many points across buildings, and follow each run. - name: Spaces description: Levels and space units of a building, and the meters located in them. - name: Space assignments description: Assign tenants to leasable spaces of a building for a period. - name: Tenants description: Tenants of a building, the people or companies that lease its spaces. - name: Meters description: >- Meters of a building, their space assignments, parent and child links, and readings. paths: /api/v1/buildings/{buildingId}/integrations/points/{pointId}/priority-array: get: tags: - Points summary: Get point priority array description: >- Returns the priority levels that currently hold a value on a point, read live from the data source. operationId: getPointPriorityArray parameters: - $ref: '#/components/parameters/BuildingId' - $ref: '#/components/parameters/PointId' responses: '200': description: The priority levels that hold a value, lowest level first. content: application/json: schema: type: array items: $ref: '#/components/schemas/PriorityLevelPublic' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: No point with this id exists in the building. '429': $ref: '#/components/responses/TooManyRequests' components: parameters: BuildingId: name: buildingId in: path required: true description: Building identifier from List buildings. schema: type: string example: 67c960faffaa42223163099e PointId: name: pointId in: path required: true description: Point identifier. schema: type: string example: zone-temp-setpoint schemas: PriorityLevelPublic: type: object properties: level: type: integer format: int32 description: Priority level. The lowest number has the highest priority. example: 8 value: type: - string - 'null' description: Value held at this level, as the data source reports it. example: '72' who: type: - string - 'null' description: Who set the value at this level, as the data source reports it. example: KODE OS responses: Unauthorized: description: The access token is missing, invalid, or expired. Request a new token. Forbidden: description: The service account lacks permission for this building or operation. TooManyRequests: description: >- A rate-limit window is exhausted. Wait, then retry with increasing delays. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Paste an access token from [Create an access token](/products/kode-api/api-reference/authentication/create-an-access-token). Tokens expire, so request a new one if you receive `401`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.