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

# Pobierz kontakt

> Pobierz pojedynczy kontakt po adresie email

## Parametry ścieżki

<ParamField path="email" type="string" required>
  Adres email kontaktu
</ParamField>

## Odpowiedź

<ResponseField name="success" type="boolean">
  Wskazuje czy żądanie zakończyło się sukcesem
</ResponseField>

<ResponseField name="data" type="object">
  Obiekt kontaktu

  <Expandable title="Pola kontaktu">
    <ResponseField name="id" type="integer">
      Unikalny identyfikator kontaktu
    </ResponseField>

    <ResponseField name="email" type="string">
      Adres email kontaktu
    </ResponseField>

    <ResponseField name="first_name" type="string">
      Imię kontaktu
    </ResponseField>

    <ResponseField name="last_name" type="string">
      Nazwisko kontaktu
    </ResponseField>

    <ResponseField name="phone" type="string">
      Numer telefonu kontaktu
    </ResponseField>

    <ResponseField name="tags" type="array">
      Tablica nazw tagów przypisanych do kontaktu
    </ResponseField>

    <ResponseField name="lead_score" type="integer">
      Ocena potencjalnego klienta
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Znacznik czasu utworzenia w formacie ISO 8601
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Znacznik czasu ostatniej aktualizacji w formacie ISO 8601
    </ResponseField>
  </Expandable>
</ResponseField>

## Przykład

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.mailist.com/api/v1/contacts/john@example.com \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.mailist.com/api/v1/contacts/john@example.com', {
    headers: {
      'X-API-Key': 'YOUR_API_KEY'
    }
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.mailist.com/api/v1/contacts/john@example.com',
      headers={'X-API-Key': 'YOUR_API_KEY'}
  )

  data = response.json()
  ```
</CodeGroup>

## Odpowiedź

<ResponseExample>
  ```json 200 Sukces theme={null}
  {
    "success": true,
    "data": {
      "id": 123,
      "email": "john@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "phone": "+1234567890",
      "tags": ["premium", "engaged"],
      "lead_score": 85,
      "created_at": "2025-01-15T10:30:00",
      "updated_at": "2025-12-30T09:00:00"
    }
  }
  ```

  ```json 404 Nie znaleziono theme={null}
  {
    "success": false,
    "error": {
      "code": "CONTACT_NOT_FOUND",
      "message": "Nie znaleziono kontaktu o adresie email: john@example.com"
    }
  }
  ```

  ```json 403 Brak uprawnień theme={null}
  {
    "success": false,
    "error": {
      "code": "PERMISSION_DENIED",
      "message": "Klucz API nie posiada uprawnienia 'contacts.read'"
    }
  }
  ```
</ResponseExample>