> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get identities > Retrieve a paginated list of identities. Each identity exposes `linkedinAccess` (LinkedIn capabilities such as `salesNav`) and `linkedinSearchEnabled` (whether it can run AI Finder LinkedIn searches). Use `linkedinSearchEnabled=true` to list the identities you can pass as `identityId` to POST /v1/ai-finder/previews to run an identity-scoped LinkedIn list. Responses include direct Enginy app URLs when available. Each identity response includes an `appUrl` that opens the identity in Enginy. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `IDENTITIES_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/identities openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/identities: get: tags: - Identities summary: Get identities description: >- Retrieve a paginated list of identities. Each identity exposes `linkedinAccess` (LinkedIn capabilities such as `salesNav`) and `linkedinSearchEnabled` (whether it can run AI Finder LinkedIn searches). Use `linkedinSearchEnabled=true` to list the identities you can pass as `identityId` to POST /v1/ai-finder/previews to run an identity-scoped LinkedIn list. Responses include direct Enginy app URLs when available. Each identity response includes an `appUrl` that opens the identity in Enginy. MCP agents should return those URLs to users whenever they are present in the response. > **Required scope:** `IDENTITIES_READ` > > **Rate limit:** 100 requests per minute parameters: - schema: type: string default: '1' description: Page number for pagination. Minimum value is 1. Defaults to 1. required: false description: Page number for pagination. Minimum value is 1. Defaults to 1. name: page in: query - schema: type: string default: '25' description: >- Number of items per page. Minimum is 1, maximum is 100. Defaults to 25. required: false description: >- Number of items per page. Minimum is 1, maximum is 100. Defaults to 25. name: pageSize in: query - schema: type: string description: Search term to filter identities by name (case-insensitive). required: false description: Search term to filter identities by name (case-insensitive). name: search in: query - schema: type: string enum: - 'true' - 'false' description: >- Filter identities by whether they can run AI Finder LinkedIn searches. `true` returns only identities with Sales Navigator access and valid LinkedIn credentials (the ones eligible to pass as `identityId` to POST /v1/ai-finder/previews); `false` returns the rest. required: false description: >- Filter identities by whether they can run AI Finder LinkedIn searches. `true` returns only identities with Sales Navigator access and valid LinkedIn credentials (the ones eligible to pass as `identityId` to POST /v1/ai-finder/previews); `false` returns the rest. name: linkedinSearchEnabled in: query responses: '200': description: Successful response with paginated identities content: application/json: schema: type: object properties: status: type: string enum: - success data: type: array items: type: object properties: id: type: number description: Unique identifier for the identity appUrl: type: string format: uri description: Direct Enginy app URL for opening this identity. name: type: - string - 'null' description: Full name of the identity firstName: type: - string - 'null' description: First name of the identity lastName: type: - string - 'null' description: Last name of the identity jobTitle: type: - string - 'null' description: Job title of the identity email: type: - string - 'null' description: Email address of the identity phoneNumber: type: - string - 'null' description: Phone number of the identity emails: type: array items: type: string description: >- All mailbox email addresses associated with the identity linkedInUrl: type: - string - 'null' description: LinkedIn profile URL of the identity scheduleMeetingUrl: type: - string - 'null' description: Meeting scheduling URL for the identity timezone: type: - string - 'null' description: Timezone of the identity profileOverview: type: - string - 'null' description: Identity profile overview used by the AI playbook keyResponsibilities: type: - string - 'null' description: Identity responsibilities used by the AI playbook interests: type: array items: type: string description: Identity interests or professional functions languages: type: array items: type: string description: Languages associated with the identity gender: type: - string - 'null' enum: - MALE - FEMALE - OTHER - null description: Identity gender value, when configured seniorityLevel: type: - string - 'null' enum: - IN_TRAINING - ENTRY_LEVEL - SENIOR - STRATEGIC - ENTRY_LEVEL_MANAGER - EXPERIENCED_MANAGER - DIRECTOR - VICE_PRESIDENT - CXO - OWNER_PARTNER - null description: Identity seniority level, when configured educations: type: - string - 'null' description: Education history used by the AI playbook previousPositions: type: - string - 'null' description: Previous positions used by the AI playbook countryCode: type: - string - 'null' description: >- Country code associated with the identity proxy or context signature: type: - string - 'null' description: >- Email signature HTML appended to outbound emails sent from this identity. createdAt: type: string format: date-time description: Date and time when the identity was created linkedinAccess: type: array items: type: string enum: - salesNav - recruiter - premium - advertiseBadge - hiringManagerMailbox description: >- LinkedIn access levels enabled for this identity (e.g. `salesNav`, `recruiter`, `premium`). Empty when no LinkedIn account is connected. Sales Navigator (`salesNav`) is required to run AI Finder LinkedIn searches. linkedinSearchEnabled: type: boolean description: >- Whether this identity can run AI Finder LinkedIn searches — true when it has Sales Navigator access and its LinkedIn credentials are not expired. Pass this identity’s `id` as `identityId` to POST /v1/ai-finder/previews to scope a LinkedIn list to this account. required: - id - appUrl - name - firstName - lastName - jobTitle - email - phoneNumber - emails - linkedInUrl - scheduleMeetingUrl - timezone - profileOverview - keyResponsibilities - interests - languages - gender - seniorityLevel - educations - previousPositions - countryCode - signature - createdAt - linkedinAccess - linkedinSearchEnabled pagination: type: object properties: page: type: number pageSize: type: number total: type: number totalPages: type: number required: - page - pageSize - total - totalPages required: - status - data - pagination security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ````