> ## Documentation Index
> Fetch the complete documentation index at: https://dench.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search bounded pages of readable CRM entries, optionally projecting cells. Always follow continueCursor until isDone

> Search bounded pages of readable CRM entries, optionally projecting cells. Always follow continueCursor until isDone.



## OpenAPI

````yaml /api-reference/openapi.json get /crm/search/page
openapi: 3.1.0
info:
  title: Dench API
  version: 1.0.0
  description: >-
    Versioned Dench workspace API. The operation registry is shared with the
    Dench CLI parity layer, so every CLI command maps to an endpoint here.
servers:
  - url: https://www.dench.com/api/v1
security: []
tags:
  - name: agent-config
    description: Agent Config operations.
  - name: approvals
    description: Approvals operations.
  - name: apps
    description: Apps operations.
  - name: auth
    description: Auth operations.
  - name: billing
    description: Billing operations.
  - name: browser
    description: Browser operations.
  - name: campaigns
    description: Campaigns operations.
  - name: chat
    description: Chat operations.
  - name: crm
    description: Crm operations.
  - name: email
    description: Email operations.
  - name: environments
    description: Environments operations.
  - name: files
    description: Files operations.
  - name: gateway
    description: Gateway operations.
  - name: lists
    description: Lists operations.
  - name: local
    description: Local operations.
  - name: meetings
    description: Meetings operations.
  - name: members
    description: Members operations.
  - name: memory
    description: Memory operations.
  - name: meta
    description: Meta operations.
  - name: notifications
    description: Notifications operations.
  - name: routines
    description: Routines operations.
  - name: secrets
    description: Secrets operations.
  - name: settings
    description: Settings operations.
  - name: workspace
    description: Workspace operations.
paths:
  /crm/search/page:
    get:
      tags:
        - crm
      summary: >-
        Search bounded pages of readable CRM entries, optionally projecting
        cells. Always follow continueCursor until isDone
      description: >-
        Search bounded pages of readable CRM entries, optionally projecting
        cells. Always follow continueCursor until isDone.
      operationId: crm_search_page
      parameters:
        - name: withReferences
          in: query
          required: false
          schema:
            description: >-
              Include bounded navigation references. Array reads return {data,
              references, referenceCoverage}; existing result envelopes keep
              their fields.
            type: boolean
          description: >-
            Include bounded navigation references. Array reads return {data,
            references, referenceCoverage}; existing result envelopes keep their
            fields.
        - name: text
          in: query
          required: true
          schema:
            type: string
            description: Full-text query over readable entries.
          description: Full-text query over readable entries.
        - name: objectName
          in: query
          required: false
          schema:
            type: string
        - name: select
          in: query
          required: false
          schema:
            minItems: 1
            maxItems: 30
            type: array
            items:
              type: string
              minLength: 1
        - name: selectionMode
          in: query
          required: false
          schema:
            description: >-
              Defaults to strict. Explicit modes require objectName and select.
              Compact recovers unknown selected names with bounded canonical
              columns and explicit selectionFallback metadata in the same
              response. Does not guess aliases.
            type: string
            enum:
              - strict
              - compact
          description: >-
            Defaults to strict. Explicit modes require objectName and select.
            Compact recovers unknown selected names with bounded canonical
            columns and explicit selectionFallback metadata in the same
            response. Does not guess aliases.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            description: >-
              Use the preceding continueCursor, with the same query and
              projection.
            type: string
          description: >-
            Use the preceding continueCursor, with the same query and
            projection.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  references:
                    maxItems: 100
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            kind:
                              type: string
                              const: crm-entry
                            objectName:
                              type: string
                            entryId:
                              type: string
                            label:
                              type: string
                            href:
                              type: string
                            url:
                              type: string
                            imageUrl:
                              type: string
                            objectIcon:
                              type: string
                          required:
                            - kind
                            - objectName
                            - entryId
                            - label
                            - href
                          additionalProperties: false
                        - type: object
                          properties:
                            kind:
                              type: string
                              const: crm-object
                            objectName:
                              type: string
                            label:
                              type: string
                            href:
                              type: string
                            url:
                              type: string
                            imageUrl:
                              type: string
                            objectIcon:
                              type: string
                          required:
                            - kind
                            - objectName
                            - label
                            - href
                          additionalProperties: false
                        - type: object
                          properties:
                            kind:
                              type: string
                              const: campaign
                            sequenceId:
                              type: string
                            label:
                              type: string
                            href:
                              type: string
                            url:
                              type: string
                            imageUrl:
                              type: string
                            objectIcon:
                              type: string
                          required:
                            - kind
                            - sequenceId
                            - label
                            - href
                          additionalProperties: false
                  referenceCoverage:
                    type: object
                    properties:
                      returned:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      available:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      truncated:
                        type: boolean
                    required:
                      - returned
                      - available
                      - truncated
                    additionalProperties: false
                  page:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        objectId:
                          type: string
                        data:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties: {}
                          description: Field-name -> cell value map.
                      required:
                        - _id
                        - objectId
                        - data
                      additionalProperties: false
                  isDone:
                    type: boolean
                  continueCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                  returnedCount:
                    type: number
                  selectedFields:
                    anyOf:
                      - type: array
                        items:
                          type: string
                      - type: 'null'
                  selectionFallback:
                    description: >-
                      Present only when compact mode recovered unknown selected
                      fields. selectedFields and row keys use actual canonical
                      names; unresolved names are never fabricated as empty
                      cells. Truncated values are previews, not complete cell
                      values.
                    type: object
                    properties:
                      mode:
                        type: string
                        const: compact
                      requestedFields:
                        type: array
                        items:
                          type: string
                      unresolvedFields:
                        type: array
                        items:
                          type: string
                      availableFields:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            type:
                              type: string
                          required:
                            - name
                            - type
                          additionalProperties: false
                      availableFieldCount:
                        type: number
                      schemaTruncated:
                        type: boolean
                      omittedFieldCount:
                        type: number
                      truncatedValues:
                        type: array
                        items:
                          type: object
                          properties:
                            entryId:
                              type: string
                            fields:
                              type: array
                              items:
                                type: string
                          required:
                            - entryId
                            - fields
                          additionalProperties: false
                    required:
                      - mode
                      - requestedFields
                      - unresolvedFields
                      - availableFields
                      - availableFieldCount
                      - schemaTruncated
                      - omittedFieldCount
                      - truncatedValues
                    additionalProperties: false
                  completeness:
                    type: string
                    const: page
                required:
                  - page
                  - isDone
                  - continueCursor
                  - returnedCount
                  - selectedFields
                  - completeness
                additionalProperties: false
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - DenchApiKey: []
        - AgentSession: []
components:
  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Operation or resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    InternalError:
      description: Server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  schemas:
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
            - code
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
            details: {}
  securitySchemes:
    DenchApiKey:
      type: http
      scheme: bearer
      bearerFormat: DENCH_API_KEY
      description: >-
        Workspace-scoped Dench API key from workspace settings. This is the same
        key used by DENCH_API_KEY in sandboxes.
    AgentSession:
      type: http
      scheme: bearer
      bearerFormat: dch_agent_*
      description: >-
        Agent session token created by `dench signin`. Gateway-backed routes
        exchange this token for the workspace gateway key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.