> ## Documentation Index > Fetch the complete documentation index at: https://docs.quoindata.com/llms.txt > Use this file to discover all available pages before exploring further. # get_entity ## OpenAPI ````yaml https://portal.quoindata.com/api/v2/openapi.json get /api/v2/entities/{entity_ref} openapi: 3.1.0 info: title: Quoin Property Intelligence API version: quoin-v2 description: Tenant-scoped source-linked property data. servers: - url: https://portal.quoindata.com security: - bearer_auth: [] paths: /api/v2/entities/{entity_ref}: get: summary: get_entity operationId: get_entity parameters: - name: entity_ref in: path required: true schema: type: string minLength: 1 maxLength: 512 responses: '200': description: Canonical response envelope. headers: X-Quoin-Balance-Micro-USD: description: Remaining welcome credit after the call, in micro-USD. schema: type: integer format: int64 X-Quoin-Held-Micro-USD: description: Outstanding reserved credit after settlement, in micro-USD. schema: type: integer format: int64 minimum: 0 X-Quoin-Price-Micro-USD: description: Rate snapshot price for the admitted call, in micro-USD. schema: type: integer format: int64 minimum: 0 X-Quoin-Rate-Version: description: Version of the rate card used for the admitted call. schema: type: string X-Quoin-Calls-30d: description: Account call count in the rolling 30-day window. schema: type: integer format: int64 minimum: 0 content: application/json: schema: $ref: '#/components/schemas/ResponseEnvelopeV2_get_entity' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '409': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '500': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' default: $ref: '#/components/responses/Error' security: - bearer_auth: [] components: schemas: ResponseEnvelopeV2_get_entity: type: object properties: contract_version: type: string const: quoin-v2 request_id: type: string minLength: 1 maxLength: 512 operation: type: string minLength: 1 maxLength: 256 status: type: string enum: - ok - partial - error data: anyOf: - type: object properties: entity: type: object properties: entity_ref: type: string minLength: 1 maxLength: 512 entity_kind: type: string minLength: 1 maxLength: 256 area_uid: anyOf: - type: string minLength: 1 maxLength: 128 - type: 'null' generation_id: anyOf: - type: string minLength: 1 maxLength: 256 - type: 'null' status: type: string enum: - current - retired - superseded identifiers: default: [] maxItems: 100 type: array items: type: object properties: authority_uid: type: string minLength: 1 maxLength: 256 namespace: type: string minLength: 1 maxLength: 256 raw_value: type: string minLength: 1 maxLength: 512 normalized_value: type: string maxLength: 512 normalization_version: type: string minLength: 1 maxLength: 256 valid_from: anyOf: - type: string minLength: 1 maxLength: 64 - type: 'null' valid_to: anyOf: - type: string minLength: 1 maxLength: 64 - type: 'null' status: type: string enum: - current - historical - retired - superseded required: - namespace - raw_value additionalProperties: false attributes: default: {} type: object propertyNames: type: string additionalProperties: {} source_refs: default: [] maxItems: 100 type: array items: type: string minLength: 1 maxLength: 512 coverage_status: type: string enum: - available - partial - gated - unavailable - stale - source_unavailable - retired - not_applicable valid_from: anyOf: - type: string minLength: 1 maxLength: 64 - type: 'null' valid_to: anyOf: - type: string minLength: 1 maxLength: 64 - type: 'null' required: - entity_ref - entity_kind additionalProperties: false required: - entity additionalProperties: {} - type: 'null' error: anyOf: - type: object properties: code: type: string minLength: 1 maxLength: 256 message: type: string minLength: 1 maxLength: 4000 retryable: type: boolean retry_after_seconds: type: integer minimum: 0 maximum: 9007199254740991 details: {} required: - code - message - retryable additionalProperties: false - type: 'null' meta: type: object properties: served_at: type: string minLength: 1 maxLength: 64 publication_id: type: string minLength: 1 maxLength: 256 generation_ids: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 256 truncated: type: boolean next_cursor: type: string minLength: 1 maxLength: 4096 warnings: maxItems: 100 type: array items: type: string maxLength: 1000 usage_units: type: number minimum: 0 required: - served_at - truncated additionalProperties: false provenance: anyOf: - type: object properties: source_refs: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 512 sources: maxItems: 100 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 512 source_kind: type: string minLength: 1 maxLength: 256 publisher: type: string minLength: 1 maxLength: 256 release_id: type: string minLength: 1 maxLength: 256 captured_at: type: string minLength: 1 maxLength: 64 official_url: type: string maxLength: 2048 format: uri required: - source_ref - source_kind additionalProperties: false required: - source_refs - sources additionalProperties: false - type: 'null' required: - contract_version - request_id - operation - status - data - error - meta additionalProperties: false ResponseEnvelopeV2: type: object properties: contract_version: type: string const: quoin-v2 request_id: type: string minLength: 1 maxLength: 512 operation: type: string minLength: 1 maxLength: 256 status: type: string enum: - ok - partial - error data: anyOf: - {} - type: 'null' error: anyOf: - type: object properties: code: type: string minLength: 1 maxLength: 256 message: type: string minLength: 1 maxLength: 4000 retryable: type: boolean retry_after_seconds: type: integer minimum: 0 maximum: 9007199254740991 details: {} required: - code - message - retryable additionalProperties: false - type: 'null' meta: type: object properties: served_at: type: string minLength: 1 maxLength: 64 publication_id: type: string minLength: 1 maxLength: 256 generation_ids: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 256 truncated: type: boolean next_cursor: type: string minLength: 1 maxLength: 4096 warnings: maxItems: 100 type: array items: type: string maxLength: 1000 usage_units: type: number minimum: 0 required: - served_at - truncated additionalProperties: false provenance: anyOf: - type: object properties: source_refs: maxItems: 100 type: array items: type: string minLength: 1 maxLength: 512 sources: maxItems: 100 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 512 source_kind: type: string minLength: 1 maxLength: 256 publisher: type: string minLength: 1 maxLength: 256 release_id: type: string minLength: 1 maxLength: 256 captured_at: type: string minLength: 1 maxLength: 64 official_url: type: string maxLength: 2048 format: uri required: - source_ref - source_kind additionalProperties: false required: - source_refs - sources additionalProperties: false - type: 'null' required: - contract_version - request_id - operation - status - data - error - meta additionalProperties: false responses: Error: description: Canonical error response. content: application/json: schema: $ref: '#/components/schemas/ResponseEnvelopeV2' securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: qk_... description: >- Send `Authorization: Bearer qk_…` using an API key created in the Quoin Developer Portal. ````