---
title: "Search Contacts"
method: POST
path: "/api/v3/contacts/search"
tags: ["Contacts"]
---

# Search Contacts

`POST /api/v3/contacts/search`

Search for contacts using complex criteria.
Uses POST because search criteria are complex and better suited for request body.

## Request body

- ContactSearchCriteria
  - `description` string, required
  - `institution_id` string, required
  - `start_date` string, nullable
  - `end_date` string, nullable
  - `search_type` string, nullable
  - `email_statuses` EmailStatus[], nullable

## Response `200`

Successful Response

- AppTypesContactsContactResponseContactResponse[]
  - `id` integer, nullable
  - `full_name` string, required
  - `title` string, required
  - `email` string, nullable
  - `phone` string, nullable
  - `institution_id` string, required
  - `updated_at` string, date-time, nullable
  - `scrape_timestamp` string, date-time, nullable
  - `scraper_filename` string, nullable
  - `email_status` string, nullable
  - `entity_name` string, nullable
  - `mailing_address` string, nullable
  - `search_metadata` SearchMetadata
    - `reason` string, required
    - `citations` string[], required
    - `direct_match` boolean, required
    - `verified` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)