> ## Documentation Index > Fetch the complete documentation index at: https://doc.youverify.co/llms.txt > Use this file to discover all available pages before exploring further. # Get All Entity > Retrieves a paginated list of entities, with support for filtering by type, status, country, and search terms. ## OpenAPI ````yaml /api-reference/specs/cowork.json get /v2/api/entities openapi: 3.0.3 info: title: Youverify Cowork API version: 2.0.0 description: >- Entity, Activity, Signal and Case Management endpoints — the core Cowork platform object model. Assembled from doc.youverify.co/api-reference-sdk, endpoints kept in the exact order they appear in the GitBook navigation. Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid verification calls; 404 on lookup-by-ID calls) are sourced verbatim from Youverify's own "Youverify OS Error Codes" and "Response Codes" pages (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and attached via components.responses, since those pages document them account-wide rather than per endpoint. Any error example that a specific endpoint's own page actually showed is kept exactly as documented there instead of being replaced by these. contact: name: Youverify Support email: support@youverify.co servers: - url: https://api.youverify.co description: Production (live, billed) - url: https://api.sandbox.youverify.co description: Sandbox (test data, not billed) security: - ApiKeyAuth: [] tags: - name: Entity Management description: >- Create, retrieve and verify entities (individuals or businesses) — the core object every check attaches to. - name: Activity Management description: Inspect the verification activities run against your account. - name: Signal Management description: Retrieve monitoring signals and their events, by entity or business. - name: Case Management description: Create and manage compliance cases, including AI-generated case summaries. paths: /v2/api/entities: get: tags: - Entity Management summary: Get All Entity description: >- Retrieves a paginated list of entities, with support for filtering by type, status, country, and search terms. operationId: getAllEntity parameters: - name: token in: header required: true schema: type: string description: API secret token - name: sortField in: query required: false schema: type: string description: Field to sort by - name: sortOrder in: query required: false schema: type: string description: Sort order, either 'asc' or 'desc' - name: searchTerm in: query required: false schema: type: string description: Search query - name: limit in: query required: false schema: type: number description: 'Number of logs to return (default: 20)' - name: startDate in: query required: false schema: type: string description: Start date - name: endDate in: query required: false schema: type: string description: End date - name: status in: query required: false schema: type: string description: Comma separated list of statuses - name: entityType in: query required: false schema: type: string description: Type of entity (individual or business) - name: businessIds in: query required: false schema: type: string description: Admin use only (comma separated list of business IDs) - name: countryCodes in: query required: false schema: type: string description: A comma separated list of country codes - name: isUBO in: query required: false schema: type: boolean description: Whether the entity is a UBO (Ultimate Beneficial Owner) responses: '200': description: Success content: application/json: example: success: true statusCode: 200 message: Entities fetched successfully! data: docs: - _id: 685c87dfe1d184f2663b4e41 businessId: 61d880f1e8e15aaf24558f1a entityType: business incorporationNumber: RC00000002 incorporationName: Kord Industries incorporationDate: '2019-06-09' address: Somewhere on palmeras city businessType: Corporate Equity taxId: null status: not_approved profileStatus: pending incorporationCountry: NG createdBy: 61f162ec1fd251c3a63f31c2 isOnboarded: true potentialEntityMatch: null createdAt: '2025-06-25T23:35:59.293Z' lastModifiedAt: '2025-06-25T23:35:59.293Z' _createdAt: 2025-06-26T00:35:5959+01:00 _lastModifiedAt: 2025-06-26T00:35:5959+01:00 object: entity id: ent_685c87dfe1d184f2663b4e41 - businessId: 61d880f1e8e15aaf24558f1a id: ent_68ae3859d82e350f82fd9e95 firstName: Sarah lastName: Doe middleName: Jane entityType: individual gender: female taxId: null status: created profileStatus: pending isOnboarded: true dateOfBirth: '1988-04-04' createdAt: '2025-08-26T22:42:33.879Z' lastModifiedAt: '2025-08-26T22:42:37.860Z' createdBy: 61f162ec1fd251c3a63f31c2 _id: 68ae3859d82e350f82fd9e95 object: entity pagination: type: cursor perPage: 20 nextPage: 685c7479519d82bd21a42fba prevPage: null hasNextPage: true hasPrevPage: false searchTerms: {} links: [] '401': $ref: '#/components/responses/Error401Unauthorized' '429': $ref: '#/components/responses/Error429TooManyRequests' '500': $ref: '#/components/responses/Error500ServerError' components: responses: Error401Unauthorized: description: Unauthorized — the token header is missing or invalid. content: application/json: example: success: false statusCode: 401 message: Permission denied name: UnauthorizedError data: {} Error429TooManyRequests: description: Too Many Requests — you have exceeded the rate limit; wait and retry. content: application/json: example: success: false statusCode: 429 message: Too many requests name: RateLimitError data: {} Error500ServerError: description: >- Internal Server Error — a rare, unexpected failure on Youverify's side. Contact support@youverify.co if it persists. content: application/json: example: success: false statusCode: 500 message: Internal Server Error name: Error data: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: token description: Your Youverify API secret key. Never expose client-side. ````