> ## Documentation Index > Fetch the complete documentation index at: https://help.kenekt.app/llms.txt > Use this file to discover all available pages before exploring further. # Get an agent's engagement > One agent's profile and activity summary. ## OpenAPI ````yaml /api-reference/management-openapi.yaml get /{agency_uid}/insights/engagements/{id} openapi: 3.0.3 info: title: Kenekt Management API version: v1 description: >- Manage an agency's stock and team: projects, lots, packages, designs, facades, developments, inclusions, commission rates, members and groups. Authenticate with an API key from a staff or admin member's account page, sent as `Authorization: Bearer YOUR_API_KEY`. A key works on every agency where its holder has a staff role; put that agency's public id in the path. This API is evolving: endpoints and fields may change without notice. servers: - url: https://app.kenekt.com.au/v1 security: [] tags: - name: Stock / Projects description: 'Projects: a stage or release inside a development, grouping the lots.' - name: Stock / Lots description: Lots, their status, and moves between projects. - name: Stock / Packages description: 'Property packages: the sellable pairing of a lot with a design and facade.' - name: Stock / Designs description: Designs, their price tiers, rooms, and linked facades. - name: Stock / Facades description: Facades offered against designs. - name: Stock / Developments description: 'Developments: the estate or masterplanned community projects sit inside.' - name: Stock / Inclusions description: Inclusion packages, their items, and what they are linked to. - name: Stock / Commission Rates description: Commission rates and what they are applied to. - name: Stock / Attachments description: Photos and documents on any stock resource. - name: Stock / Library description: >- The whole library (designs, price tiers, facades, inclusions) as flat export rows. - name: Team / Members description: Members of the agency, their API keys, documents, and inclusions. - name: Team / Groups description: User groups and their memberships. - name: Team / Engagement description: >- Agent engagement: who is active, who has gone quiet, what they view and search for. - name: Agency description: The agency record and its settings. - name: Agency / Documents description: Agency-level documents. - name: EOIs description: Expressions of interest, purchasers, and sighted ID capture. paths: /{agency_uid}/insights/engagements/{id}: get: tags: - Team / Engagement summary: Get an agent's engagement description: One agent's profile and activity summary. parameters: - name: agency_uid in: path required: true schema: type: string description: Agency public_uid - name: days in: query required: false schema: type: integer example: 30 - name: id in: path required: true schema: type: string example: nobody-here responses: '200': description: OK headers: Content-Type: schema: type: string content: application/json: schema: type: object properties: agent: type: object properties: public_uid: type: string name: type: string email: type: string phone: nullable: true last_active_on: nullable: true role: type: string disabled: type: boolean works_at_kenekt: type: boolean last_login_at: nullable: true last_seen_at: nullable: true required: - public_uid - name - email - phone - last_active_on - role - disabled - works_at_kenekt - last_login_at - last_seen_at counts: type: object properties: views: type: integer searches: type: integer flyers: type: integer lists: type: integer enquiries: type: integer mcp_calls: type: integer required: - views - searches - flyers - lists - enquiries - mcp_calls packages: type: array items: type: object properties: public_uid: type: string address: type: string project: type: string supplier: type: string views: type: integer required: - public_uid - address - project - supplier - views packages_truncated: type: boolean searches: type: object properties: summary: type: object properties: total: type: integer nl_searches: type: integer failed: type: integer unique_users: type: integer required: - total - nl_searches - failed - unique_users top_suburbs: type: array items: {} top_regions: type: array items: {} top_bedrooms: type: array items: {} price_buckets: type: array items: type: object properties: value: type: string count: type: integer required: - value - count recent_nl_queries: type: array items: {} failed_queries: type: array items: {} required: - summary - top_suburbs - top_regions - top_bedrooms - price_buckets - recent_nl_queries - failed_queries activity: type: array items: {} period: type: object properties: days: type: integer from: type: string to: type: string required: - days - from - to required: - agent - counts - packages - packages_truncated - searches - activity - period example: agent: public_uid: USR-USER1-001 name: User One email: user1@example.com phone: null last_active_on: null role: agent disabled: false works_at_kenekt: false last_login_at: null last_seen_at: null counts: views: 1 searches: 0 flyers: 0 lists: 0 enquiries: 0 mcp_calls: 0 packages: - public_uid: BP-1234 address: 123 Test St NORTH ROCKS NSW 2151 project: Northam Estate supplier: Test Agency views: 1 packages_truncated: false searches: summary: total: 0 nl_searches: 0 failed: 0 unique_users: 0 top_suburbs: [] top_regions: [] top_bedrooms: [] price_buckets: - value: Under $400k count: 0 - value: $400–500k count: 0 - value: $500–600k count: 0 - value: $600–700k count: 0 - value: $700–800k count: 0 - value: $800k+ count: 0 recent_nl_queries: [] failed_queries: [] activity: [] period: days: 30 from: '2026-08-21T09:31:23+10:00' to: '2026-09-20T09:31:23+10:00' '404': description: Not Found headers: Content-Type: schema: type: string content: application/json: schema: type: object properties: error: type: string required: - error example: error: Not found '422': description: Unprocessable Entity headers: Content-Type: schema: type: string content: application/json: schema: type: object properties: candidates: type: array items: type: object properties: public_uid: type: string name: type: string email: type: string required: - public_uid - name - email required: - candidates example: candidates: - public_uid: USR-USER1-001 name: Sam Lee email: user1@example.com - public_uid: USR-USER2-001 name: Sam Leigh email: user2@example.com security: - bearer_auth: [] components: securitySchemes: bearer_auth: type: http scheme: bearer bearerFormat: Token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.