> ## Documentation Index > Fetch the complete documentation index at: https://docs.govly.com/llms.txt > Use this file to discover all available pages before exploring further. # Search contacts > Search government points of contact with the constrained public parameter set shared by MCP search_contacts. Email and phone are never returned in search results; use show_contact for a single contact. jurisdictionLevel defaults to federal. ## OpenAPI ````yaml /openapi/tools-v1.yaml post /api/tools/v1/contacts/search openapi: 3.1.0 info: title: Govly Tools API (Alpha) version: 1.0.0-alpha description: > ALPHA / UNSTABLE: This API is still in active development. Endpoint behavior, request fields, response fields, error codes, and operation names may change before the Tools API is declared stable. REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Responses are JSON for typed clients; MCP tools may render action results into text-oriented formats separately. servers: - url: https://app.govly.com security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Opportunities description: Search, fetch, and inspect Govly opportunity records. - name: Awards description: Search and inspect awarded government contracts. - name: Contacts description: Search and inspect government points of contact. - name: Workspaces description: Create, update, and inspect opportunity workspaces. - name: Workspace Members description: Add users and teams to workspaces. - name: Workspace Attachments description: List and upload workspace attachments. - name: Workspace Comments description: Post comments to workspaces. - name: Follows description: Follow opportunities and related workspace activity. - name: Saved Searches description: List saved opportunity searches and cached matches. - name: Documents description: >- Read document representations and request temporary original-file downloads. - name: Quote Submissions description: >- Inspect quote submission requirements, submit quotes, and poll submission status. - name: Inbox description: Read and triage the authenticated user's matched inbox items. paths: /api/tools/v1/contacts/search: post: tags: - Contacts summary: Search contacts description: > Search government points of contact with the constrained public parameter set shared by MCP search_contacts. Email and phone are never returned in search results; use show_contact for a single contact. jurisdictionLevel defaults to federal. operationId: search_contacts requestBody: required: false content: application/json: schema: type: object additionalProperties: false properties: query: type: string description: >- Search text. Matches names, titles, vendors, buyers, and products. Supports quoted phrases and boolean operators such as AND, OR, and NOT. cursor: type: string description: > Opaque pagination token from the previous response's meta.nextCursor. Omit for the first page. Tokens are bound to the query, filters, and sort inputs and carry no format guarantee. perPage: type: integer default: 25 maximum: 100 sort: type: string enum: - last_active - opp_count description: >- Sort field. Defaults to last_active (most recently active first). sortDirection: type: string enum: - asc - desc jurisdictionLevel: type: string enum: - federal - regional description: >- Filter by government level - federal (country-level) or regional (state/local). Defaults to federal when omitted. buyerIds: type: array items: type: string description: >- Filter to contacts associated with any of these Govly buyer (government entity) ids. buyerDomains: type: array items: type: string description: >- Filter to contacts associated with any of these buyer email domains, such as gsa.gov. vendorNames: type: array items: type: string description: >- Filter to contacts associated with any of these vendor names. titles: type: array items: type: string description: >- Filter to contacts holding any of these job titles, such as Contracting Officer. responses: '200': description: Matching contacts content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/Contact' meta: $ref: '#/components/schemas/CursorMeta' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' components: schemas: Contact: type: object required: - id description: > Stable external contact shape. Empty members are omitted. Search responses (search_contacts) return the summary shape without email or phone; detail responses (show_contact) add email and phoneNumbers for paid callers. properties: id: type: string name: type: string names: type: array items: type: string active: type: boolean lastActive: type: string oppCount: type: integer titles: type: array items: type: string jurisdictionLevels: type: array items: type: string contactUrl: type: string buyers: type: array items: type: object properties: id: type: string name: type: string vendors: type: array items: type: object properties: id: type: string name: type: string contractVehicles: type: array items: type: object properties: id: type: string slug: type: string name: type: string setAsides: type: array items: type: object properties: id: type: string name: type: string code: type: string placeLocations: type: array items: type: object properties: label: type: string city: type: string region: type: string postalCode: type: string publicEntity: type: object description: >- The government entity this contact belongs to. Detail responses only. properties: id: type: string name: type: string email: type: string description: Returned on show for paid callers; never present in search results. phoneNumbers: type: array items: type: string description: Returned on show for paid callers; never present in search results. CursorMeta: type: object required: - count properties: count: type: integer description: Number of records in this page. totalCount: type: integer description: > Total matching records (award and contact search), capped at 10,000 by the search engine. Pagination via nextCursor is not limited by this cap. perPage: type: integer searchType: type: string enum: - fed - sled - international description: > Market actually searched (opportunity and award search only). Echoes the resolved searchType, including the value defaulted from the user's market focus when the request omitted it. nextCursor: type: - string - 'null' ErrorEnvelope: type: object required: - errors properties: errors: type: array items: type: object required: - status - code - title - detail properties: status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: API key headerApiKey: type: apiKey in: header name: X-API-KEY ````