List and Get Contacts

List contacts


GET /v1/organization/contacts

Query parameters

Parameter	Type	Required	Description
`page`	number	—	Page number (default `1`)
`limit`	number	—	Page size (default `20`, max `500`)
`search`	string	—	Search by name, number, or attribute values
`tags`	string / array	—	Tag filter. Use CSV (`vip,newsletter`) or repeated params
`tag_match_mode`	`and` / `or`	—	Match behavior when multiple tags are provided
`segment_ids`	string	—	Comma-separated segment IDs

Example


curl "https://api.bahasha.app/v1/organization/contacts?page=1&limit=20&search=jane&tags=vip,newsletter&tag_match_mode=and&segment_ids=67f12bb3882d745f33f3d300" \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx"

Response


{
  "data": [
    {
      "id": "68011f5f8f7f109de8f62f5e",
      "first_name": "Jane",
      "middle_name": "",
      "last_name": "Doe",
      "full_name": "Jane Doe",
      "number": "+254700000000",
      "email": "[email protected]",
      "tags": ["vip"],
      "attributes": {
        "city": "Nairobi",
        "customer_tier": "Gold"
      },
      "segment": {
        "id": "67f12bb3882d745f33f3d300",
        "name": "Returning Customers"
      },
      "phone_number_metadata": {
        "countryCode": "254",
        "region": "KE",
        "numberType": "MOBILE",
        "e164Format": "+254700000000",
        "nationalFormat": "0700 000000"
      },
      "created_at": "2026-04-24T08:12:40.110Z",
      "updated_at": "2026-04-24T09:55:18.409Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "pages": 1
  }
}

Get a contact by ID


GET /v1/organization/contacts/:id


curl https://api.bahasha.app/v1/organization/contacts/68011f5f8f7f109de8f62f5e \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx"

Response


{
  "data": {
    "id": "68011f5f8f7f109de8f62f5e",
    "first_name": "Jane",
    "middle_name": "",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "number": "+254700000000",
    "email": "[email protected]",
    "tags": ["vip"],
    "attributes": {
      "city": "Nairobi",
      "customer_tier": "Gold"
    },
    "segment": {
      "id": "67f12bb3882d745f33f3d300",
      "name": "Returning Customers"
    }
  }
}