---
title: "Get contacts"
method: GET
path: "/bot/getContacts"
tags: ["Bot"]
---

# Get contacts

`GET /bot/getContacts`

## Request

- Base URL: `https://api.inline.chat`
- URL: `https://api.inline.chat/bot/getContacts`
- Auth: none required

Returns the people and bots the authenticated bot works with, plus those of the person it acts for: its owner, bots the owner manages, people in shared chats and spaces, and bots it may use. Each contact says why it is one and, for bots, what the authenticated bot may do with it.

## Query parameters

- `query` string
- `kind` 'all' | 'people' | 'bots'
- `limit` string: A signed decimal integer string within JavaScript's safe-integer range

## Headers

- `authorization` string, required

## Response `200`

BotGetContactsSuccess

- BotGetContactsSuccess
  - `ok` true, required: Always true for a successful request.
  - `result` object, required: Method-specific response payload.
    - `contacts` BotContact[], required
      - `user` BotUser, required: Basic information about an Inline user or bot.
        - `id` integer, required: Unique identifier for this Inline user.
        - `is_bot` boolean, required: True when the user represents a bot account.
        - `username` string: Public username, without the leading @.
        - `first_name` string: User's first or display name.
        - `last_name` string: User's last name, when available.
        - `owner_id` integer: Bots only: the person this bot acts for.
      - `relations` BotContactRelation[], required: Why this user is a contact.
      - `via_owner` boolean, required: True when every relation comes through the bot's owner rather than the bot itself.
      - `last_interaction_date` integer: Unix time in seconds of the latest shared-chat activity, when known.
      - `bot_operations` BotAgentOperation[]: Bot contacts only: what the authenticated bot may do with this bot.
      - `manages_bot` boolean: Bot contacts only: true when this bot is managed by the authenticated bot's owner.

## Other responses

- `400`: The request parameters are missing or invalid.
- `401`: The bot token is missing or invalid.
- `403`: The bot is not allowed to perform this action.
- `404`: The requested method or resource was not found.
- `429`: The bot is sending faster than its pacing budget. Wait `parameters.retry_after` seconds, also sent as `Retry-After`.
- `500`: The server could not complete the request.

## Changes

- **2026-11-10** `f9afb2deef54`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/changes/bot/getContacts/get.md)

---

[API](https://skmtc.dev/inline/apis/inline-bot-http-api-docs.md) - [All operations](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/revisions/bc9745589244?raw)