---
title: "Czy firma jest już w moich leadach"
method: GET
path: "/leads/lookup"
tags: ["Wtyczka Chrome"]
---

# Czy firma jest już w moich leadach

`GET /leads/lookup`

## Request

- Base URL: `https://outreachpilot.pl/api/v1`
- URL: `https://outreachpilot.pl/api/v1/leads/lookup`
- Auth: HTTP bearer

Sprawdza duplikat po domenie, NIP albo adresie e-mail (wystarczy jeden parametr; wynik łączy dopasowania i mówi, po czym znaleziono). Przeszukuje całe konto, także leady innych klientów agencji. Nic nie zużywa. Wymaga zakresu `extension:read`, więc działa też na kontach bez dostępu do publicznego API; użytkownicy API mogą to samo zrobić przez `GET /leads?email=`. Nieprawidłowa suma kontrolna NIP to 422.

**Wymagany zakres klucza:** `extension:read`.

## Query parameters

- `domain` string
- `nip` string
- `email` string

## Response `200`

Sukces.

- object
  - `data` LeadLookupResult, required
    - `found` boolean, required: `true`, gdy którykolwiek z podanych identyfikatorów jest już w Twoich leadach.
    - `matches` object[], required: Dopasowane leady (maks. 10), od najnowszych.
      - `lead_id` string, required
      - `matched_by` string[], required: Po czym znaleziono: domena, NIP, adres e-mail (przy zapisie także telefon oraz nazwa z miastem).
      - `company_name` string, nullable, required
      - `email` string, nullable, required
      - `company_website` string, nullable, required
      - `status` 'nowy' | 'w_kampanii' | 'odpowiedzial' | 'zainteresowany' | 'brak_zainteresowania' | 'odrzucony', required
      - `workspace_id` string, nullable, required: Klient agencji, do którego należy lead; `null` = „Moja firma”.
      - `created_at` string, required: Data i czas ISO 8601 (UTC).
      - `url` string, required: Adres leada w aplikacji (lista leadów przefiltrowana do tej firmy).

## Other responses

- `401`: Brak, zły, odwołany lub wygasły klucz (`missing_api_key`, `invalid_api_key`, `api_key_revoked`, `api_key_expired`, `account_inactive`).
- `403`: Plan nie obejmuje API (`plan_upgrade_required`, odpowiedź zawiera informacje o planie; nie dotyczy tras wtyczki z kluczem `extension:*`) albo klucz nie ma wymaganego zakresu (`insufficient_scope`).
- `422`: Błąd walidacji. Kody: `validation_error`.
- `429`: Przekroczono limit żądań (`rate_limit_exceeded`). Zobacz nagłówek `Retry-After`.

---

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