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

# List Contacts

> List all contacts for your organization. Each contact includes identifiers, contact_memories (per persona/agent), and memory entities. Paginated.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="limit" type="integer">
  Maximum number of contacts to return. Default 50, max 200.
</ParamField>

<ParamField query="offset" type="integer">
  Number of contacts to skip (for pagination). Default 0.
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of contact objects. Each includes identifiers, memories (with entities).
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata (total, limit, offset, has\_more).
</ResponseField>

<ResponseField name="pagination.total" type="integer">
  Total number of contacts in the org.
</ResponseField>

<ResponseField name="pagination.limit" type="integer">
  Limit used for this request.
</ResponseField>

<ResponseField name="pagination.offset" type="integer">
  Offset used for this request.
</ResponseField>

<ResponseField name="pagination.has_more" type="boolean">
  Whether more contacts exist after this page.
</ResponseField>

<ResponseField name="errors" type="null">
  Error array (null on success).
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "org_id": "11111111-2222-3333-4444-555555555555",
        "name": "Sarah Chen",
        "metadata": {
          "source": "inbound_call"
        },
        "created_at": "2025-07-20T10:30:00.000Z",
        "updated_at": "2025-07-23T09:15:00.000Z",
        "identifiers": [
          {
            "id": "ident-aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
            "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "identifier_type": "phone_number",
            "identifier_value": "+14155550192",
            "is_primary": true
          }
        ],
        "memories": [
          {
            "id": "mem-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "contact_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
            "persona_id": "persona-12345678",
            "agent_number": null,
            "summary": "Customer called about order #8821 which was delayed. Follow-up SMS confirmed the order shipped and is now in transit. Expected delivery July 25.",
            "facts": {
              "name": "Sarah Chen",
              "phone": "+14155550192",
              "preferred_contact": "sms",
              "timezone": "America/Los_Angeles"
            },
            "recent_messages": [
              {
                "role": "user",
                "content": "Has my order shipped yet?",
                "channel": "sms",
                "timestamp": "2025-07-23T09:10:00.000Z"
              },
              {
                "role": "assistant",
                "content": "Yes, order #8821 shipped this morning. Expected delivery is Friday July 25.",
                "channel": "sms",
                "timestamp": "2025-07-23T09:10:05.000Z"
              }
            ],
            "open_items": [
              {
                "type": "follow_up",
                "description": "Confirm delivery of order #8821 on July 25",
                "created_at": "2025-07-23T09:10:00.000Z",
                "priority": "medium",
                "related_to": {
                  "entity_type": "order",
                  "entity_id": "order-8821"
                }
              }
            ],
            "entities": [
              {
                "entity_type": "order",
                "entity_id": "order-8821",
                "facts": {
                  "order_number": "#8821",
                  "status": "in_transit",
                  "carrier": "UPS",
                  "expected_delivery": "2025-07-25"
                },
                "status": "in_transit",
                "last_discussed_at": "2025-07-23T09:10:00.000Z",
                "notes": null
              }
            ]
          }
        ]
      }
    ],
    "pagination": {
      "total": 100,
      "limit": 50,
      "offset": 0,
      "has_more": true
    },
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)