---
title: "Tamloot — חיפוש אנשי קשר"
description: "חיפוש אנשי קשר: פרמטרים, דוגמאות בקשה ומבני תשובות עבור GET /v1/contacts."
canonical: "https://tamloot.cc/he/docs/developers/api-reference/search-contacts"
last-updated: "2026-10-18"
---

# חיפוש אנשי קשר

`GET /v1/contacts`

שלחו את מפתח ה-API בכותרת `Authorization: Bearer $TAMLOOT_API_KEY`. ניתן לקרוא רק מידע שגלוי לבעל המפתח.

מבוסס על [מפרט OpenAPI שפורסם](https://tamloot.cc/openapi.json). שמות המבנים ומזהי הקוד מוצגים בדיוק כפי שהם מוגדרים ב-API.

## פרמטרים

| פרמטר | מיקום | חובה | סוג | מגבלות |
| --- | --- | --- | --- | --- |
| `query` | query | כן | string | `{"minLength":2,"maxLength":100}` |

## דוגמאות בקשה

```bash
curl "https://api.tamloot.cc/v1/contacts?query=maya" \
  --header "Authorization: Bearer $TAMLOOT_API_KEY"
```

```javascript
const response = await fetch("https://api.tamloot.cc/v1/contacts?query=maya", {
  headers: { Authorization: `Bearer ${process.env.TAMLOOT_API_KEY}` },
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
```

## תשובות

| קוד | משמעות |
| --- | --- |
| 200 | הבקשה הצליחה |
| 401 | מפתח API חסר או לא תקין |
| 422 | פרמטרים לא תקינים בבקשה |
| 429 | חריגה ממגבלת הקצב; המתינו לפי Retry-After |

### מבנה תשובה מוצלחת

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "full_name": {
            "type": "string",
            "nullable": true
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "notes": {
            "type": "string",
            "nullable": true
          },
          "memory": {
            "type": "string",
            "nullable": true,
            "description": "AI-maintained memory of this contact"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "notes_timeline": {
            "type": "array",
            "description": "Manually written notes about this contact, newest first",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "content": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "recent_sessions": {
            "type": "array",
            "description": "This contact’s most recent past sessions",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "title": {
                  "type": "string",
                  "nullable": true
                },
                "subtitle": {
                  "type": "string",
                  "nullable": true
                },
                "session_date": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "recording_status": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "inferred_name": {
            "type": "string",
            "nullable": true,
            "description": "System-inferred name for imported contacts without a user-set full_name."
          },
          "archived_at": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "null for active contacts; timestamp when archived. Direct lookup includes archived contacts."
          }
        }
      }
    }
  }
}
```

### מבנה תשובת שגיאה

```json
{
  "type": "object",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "HTTP status code as a string, e.g. \"404\""
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}
```

### כותרות תשובה

```json
{
  "RateLimit-Limit": {
    "description": "Requests allowed per one-second window.",
    "schema": {
      "type": "integer"
    }
  },
  "RateLimit-Policy": {
    "description": "The rate-limit policy, as `<limit>;w=<window seconds>`.",
    "schema": {
      "type": "string"
    }
  }
}
```

עברו ל[התחלה מהירה](/he/docs/developers/quickstart) להגדרת מפתח API, או ל[סקירת ה-API](/he/docs/developers/api) למגבלות קצב וניהול גרסאות.

## קישורים נוספים

- [Tamloot](https://tamloot.cc/he)
- [כל המדריכים](https://tamloot.cc/he/docs)
- [llms.txt](https://tamloot.cc/docs/llms.txt)
- [Sitemap](https://tamloot.cc/sitemaps/sitemap.xml)