> ## 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 jobs

> Search job postings through Dench find. `companyDomains` takes up to 1000 domains (chunked automatically); `dench jobs find --company-list <id|view>` resolves a saved company list into it.



## OpenAPI

````yaml /api-reference/openapi.json post /enrichment/jobs/search
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: 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: workspace
    description: Workspace operations.
paths:
  /enrichment/jobs/search:
    post:
      tags:
        - crm
      summary: Search jobs
      description: >-
        Search job postings through Dench find. `companyDomains` takes up to
        1000 domains (chunked automatically); `dench jobs find --company-list
        <id|view>` resolves a saved company list into it.
      operationId: enrichment_jobs_search
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                titles:
                  description: >-
                    Job titles (free text). Accepted values: see `dench leads
                    filters` or
                    https://dench.com/references/find-filter-options.json.
                  maxItems: 50
                  type: array
                  items:
                    type: string
                locations:
                  description: >-
                    Cities, states, countries, or metros (free text). Accepted
                    values: see `dench leads filters` or
                    https://dench.com/references/find-filter-options.json.
                  maxItems: 50
                  type: array
                  items:
                    type: string
                companyDomain:
                  type: string
                companyName:
                  type: string
                companyLinkedinUrl:
                  type: string
                keywords:
                  type: string
                postedAfter:
                  type: string
                limit:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 5000
                pageToken:
                  description: >-
                    Opaque token from a previous response's
                    metadata.nextPageToken.
                  type: string
                preferCache:
                  type: boolean
            example:
              titles:
                - Account Executive
              locations:
                - San Francisco
              companyDomains:
                - acme.com
                - globex.com
              limit: 50
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  source:
                    type: string
                    enum:
                      - live
                      - cache
                  jobs:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        company:
                          type: string
                        location:
                          type: string
                        url:
                          type: string
                        workplaceType:
                          type: string
                        postedAt:
                          type: string
                      additionalProperties: {}
                    description: Job postings in the canonical job_posting shape.
                  metadata:
                    type: object
                    properties:
                      total:
                        description: >-
                          Total matches for the search. Stable across pages;
                          absent when only an estimate exists.
                        type: number
                      totalIsEstimate:
                        description: >-
                          True when the total is a lower bound rather than
                          exact.
                        type: boolean
                      offset:
                        type: number
                      nextPageToken:
                        description: >-
                          Opaque token for the next page. Pass it back as
                          pageToken; absent on the last page.
                        type: string
                    additionalProperties: {}
                required:
                  - source
                  - jobs
                additionalProperties: {}
              example:
                source: live
                jobs:
                  - title: Account Executive
                    company: Acme
                    location: San Francisco
                    url: https://example.com/jobs/ae
                    workplaceType: hybrid
        '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.

````