---
title: "Search end users"
method: GET
path: "/end-users"
tags: ["End Users"]
---

# Search end users

`GET /end-users`

Search for end users.

## Query parameters

- `name` string
- `sort` 'name' | 'created' | 'updated'
- `order` 'asc' | 'desc'
- `offset` integer — Offset index (zero-based)
- `limit` integer — Limit search results

## Response `200`

Search results

- EndUserSearchResult — End user search result
  - `offset` integer, required — Offset index (zero-based)
  - `total` integer, required
  - `hasMore` boolean, required — Whether there are more results available
  - `hits` EndUser[], required
    - `name` string, required
    - `address` object, required
      - `country` string, required — ISO 3166-1 alpha-2 country code
      - `city` string
    - `comment` string
    - `sid` string, required — Short ID
    - `type` 'self' | 'third-party', required — The type of end user. It can be either **self** (your company) or **third-party**. Any end user you create is considered as third-party.
    - `created` string, date-time, required — RFC 3339, section 5.6
    - `updated` string, date-time, required — RFC 3339, section 5.6
    - `deletable` boolean — Whether the end user can be deleted or not. Self end user cannot be deleted. Third party end users can be deleted if they are not associated with any phone number.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `429` — Too Many Requests (rate limit exceeded)
- `500` — Internal Server Error

---

[API](https://skmtc.net/callr/apis/callr-rest-api-v2-0.md) · [All operations](https://skmtc.net/callr/apis/callr-rest-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callr/callr-rest-api-v2-0/revisions/76d36d004a8f/schema)