---
title: "Find a contact by email"
method: GET
path: "/api/v1/contacts"
tags: ["Contacts"]
---

# Find a contact by email

`GET /api/v1/contacts`

## Request

- Base URL: `https://mailinapp.com`
- URL: `https://mailinapp.com/api/v1/contacts`
- Auth: HTTP bearer

The address's row in each of the account's contacts lists (or only in `listId`), most recently updated first. An empty array when it's in none. Each read is recorded in the account's data-access log.

## Query parameters

- `email` string, email, required
- `listId` string

## Response `200`

Matching contacts

- object
  - `contacts` Contact[], required
    - `listId` string, required
    - `listName` string, required
    - `rowId` string, required: Stable per address: the same in every list.
    - `email` string, email, required
    - `fields` object, required
    - `status` 'active' | 'pending', required: pending until a double opt-in signup confirms.
    - `verification` object, nullable, required: The server's email verification verdict; null when not checked yet.
      - `status` 'valid' | 'risky' | 'invalid' | 'unknown', required
      - `reasons` string[], required
      - `checkedAt` integer, required: Epoch ms.
    - `createdAt` integer, required: Epoch ms.
    - `updatedAt` integer, required: Epoch ms.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `429`: Too many requests for this key

---

[API](https://skmtc.dev/mailinapp/apis/mailinapp-api.md) · [All operations](https://skmtc.dev/mailinapp/apis/mailinapp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailinapp/apis/mailinapp-api/revisions/61016f797884?raw)