> ## Documentation Index > Fetch the complete documentation index at: https://docs.bitrace.io/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Entity and Risk Assessment > getAddressEntityAndRisk - This endpoint retrieves entity and risk by given address. ## OpenAPI ````yaml GET /api/v1/tracker/kya/entities-risks openapi: 3.0.3 info: title: Bitrace AML API description: >- Bitrace AML API provides comprehensive blockchain and crypto compliance tools for real-time risk detection capabilities. The API enables scrutiny of crypto transactions, wallet addresses, and crypto tokens with precision and efficiency. version: 1.0.0 contact: name: Bitrace Support email: support@bitrace.io servers: - url: https://api.bitrace.io description: Production server security: - apiKeyAuth: [] tags: - name: KYA (Know Your Address) description: Address risk assessment and entity identification - name: KYT (Know Your Transaction) description: Transaction monitoring and compliance - name: Account API description: Account usage and management APIs - name: Address Management description: Address management on the blacklist and whitelist paths: /api/v1/tracker/kya/entities-risks: get: tags: - KYA (Know Your Address) summary: Retrieve Entity and Risk Assessment description: >- getAddressEntityAndRisk - This endpoint retrieves entity and risk by given address. parameters: - name: Content-Type in: header required: false schema: type: string default: application/json enum: - application/json - name: Accept in: header required: false schema: type: string default: application/json enum: - application/json - name: address in: query required: true schema: type: string description: The address that you want to retrieve a entity for. description: The address that you want to retrieve a entity for. - name: network in: query required: true schema: $ref: '#/components/schemas/Network' description: >- The supported chainns short name, ethereum tron btc bsc ... See at [Supported Chains](/api-reference/endpoints/supported-chains/kya-supported-chains) description: >- The supported chainns short name, ethereum tron btc bsc ... See at [Supported Chains](/api-reference/endpoints/supported-chains/kya-supported-chains) responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/KyaEntitiesRisksGetResponse' example: success: true code: 1 msg: SUCCESS data: time: 1726117290776 address: TNk8zE9iHPj8LExnLhRi8Ufs9zYbvgRc7n network: tron whitelist: false contract: false entity: entityName: Bitget User entityCode: bitget-user entityCategory: Exchange entityCategoryCode: exchange risks: - riskLevel: generally-high riskType: launder-money riskSource: Bitrace - riskLevel: generally-high riskType: black-gray-goods riskSource: Bitrace - riskLevel: high riskType: online-gambling riskSource: Bitrace '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimit' '500': $ref: '#/components/responses/InternalServerError' components: schemas: Network: type: string enum: - ethereum - eth - tron - btc - bsc - polygon - arbitrum - optimism - avalanche - base - zksync - merlin - kaia - iotex - ftm - theta - etc - lumia - solana - doge - ltc description: Supported blockchain networks KyaEntitiesRisksGetResponse: allOf: - $ref: '#/components/schemas/BaseResponse' - type: object properties: data: $ref: '#/components/schemas/KyaEntitiesRisks' BaseResponse: type: object properties: success: type: boolean description: Request success or not code: type: integer description: Response code (1 for success, other numbers for errors) msg: type: string description: SUCCESS or error message KyaEntitiesRisks: type: object properties: time: type: integer format: int64 address: type: string network: type: string whitelist: type: boolean contract: type: boolean entity: $ref: '#/components/schemas/Entity' intelligenceEntities: type: array items: $ref: '#/components/schemas/Entity' nullable: true risks: type: array items: $ref: '#/components/schemas/Risk' nullable: true Error: type: object properties: success: type: boolean description: Request success or not default: false code: type: integer msg: type: string status: type: string Entity: type: object properties: entityName: type: string description: The name of the identified entity entityCode: type: string description: The code of the identified entity entityCategory: type: string description: The category of the identified entity entityCategoryCode: type: string description: The category code of the identified entity Risk: type: object properties: riskLevel: $ref: '#/components/schemas/RiskLevel' description: The level of the risk riskType: $ref: '#/components/schemas/RiskType' description: The type of the risk riskSource: $ref: '#/components/schemas/riskSource' description: The source of the risk RiskLevel: type: string enum: - high - generally-high - low - whitelist description: The level of the risk RiskType: type: string enum: - black-gray-goods - online-gambling - scam - hack - launder-money - sanction - frozen - politics - drug - gun - terrorist - porn - controlled-substance - bloodiness - religion - csam description: The type of the risk riskSource: type: string enum: - Bitrace - Community - User-Defined responses: BadRequest: description: Bad Request - Your request is invalid content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Unauthorized - Incorrect API key provided content: application/json: schema: $ref: '#/components/schemas/Error' RateLimit: description: Too Many Requests - Rate limit reached or quota exceeded content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal Server Error - We had a problem with our server content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKeyAuth: type: apiKey in: header name: X-Access-Key description: API key authentication ````