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

# Search Contacts



## OpenAPI

````yaml get /api/2.0/contacts/search/
openapi: 3.1.0
info:
  contact:
    name: Elation Health
    url: https://www.elationhealth.com/
  description: Elation Health API v2.0
  title: Practice API
  version: 2.0.0
servers:
  - description: Sandbox Server
    url: https://sandbox.elationemr.com
  - description: Production Server
    url: https://api.app.elationemr.com
security: []
paths:
  /api/2.0/contacts/search/:
    get:
      tags:
        - Contacts
      summary: Search Contacts
      operationId: contacts_search_list
      parameters:
        - description: The city to search for contacts.
          in: query
          name: city
          schema:
            type: string
        - description: Number of results to return per page.
          in: query
          name: limit
          required: false
          schema:
            type: integer
        - description: The initial index from which to return the results.
          in: query
          name: offset
          required: false
          schema:
            type: integer
        - description: Contact name or fax number to look for.
          in: query
          name: q
          schema:
            type: string
        - description: >-
            Comma separated specialties to look for contacts. Examples:
            "psychology,dental care" or "pharmacy".
          in: query
          name: specialties
          schema:
            type: string
        - description: The state to search for contacts.
          in: query
          name: state
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedContactsSearchResultList'
          description: ''
      security:
        - oauth2: []
components:
  schemas:
    PaginatedContactsSearchResultList:
      properties:
        count:
          example: 123
          type: integer
        next:
          example: http://api.example.org/accounts/?offset=400&limit=100
          format: uri
          nullable: true
          type: string
        previous:
          example: http://api.example.org/accounts/?offset=200&limit=100
          format: uri
          nullable: true
          type: string
        results:
          items:
            $ref: '#/components/schemas/ContactsSearchResult'
          type: array
      required:
        - results
      type: object
    ContactsSearchResult:
      description: Serializer used to work with contacts found via elasticsearch
      properties:
        accepting_insurance:
          type:
            - boolean
            - 'null'
        accepting_new_patients:
          type:
            - boolean
            - 'null'
        address_line:
          maxLength: 100
          type: string
        city:
          maxLength: 30
          type: string
        contact_type:
          maxLength: 15
          type: string
        direct_address:
          maxLength: 500
          type: string
        fax:
          maxLength: 15
          type: string
        id:
          readOnly: true
          type: integer
        is_elation_confirmed:
          type:
            - boolean
            - 'null'
        is_verified:
          type:
            - boolean
            - 'null'
        name:
          maxLength: 200
          type: string
        npi:
          type: string
        phone:
          maxLength: 25
          type: string
        specialties:
          items: {}
          type: array
        specialty_categories:
          items: {}
          type: array
        state:
          maxLength: 20
          type: string
      required:
        - name
      type: object
  securitySchemes:
    oauth2:
      flows:
        clientCredentials:
          scopes:
            act_as_user: >-
              Impersonate a provider via X-On-Behalf-Of (combinable with apiv2
              or system scopes)
            apiv2: Full access to the API
            system/{resource_name}.read: Read access to a specific resource
            system/{resource_name}.write: Write access to a specific resource
          tokenUrl: /api/2.0/oauth2/token/
      type: oauth2

````