---
title: "Retrieves all connectors with IDs"
method: POST
path: "/connector/list/by-ids"
tags: ["Connector"]
---

# Retrieves all connectors with IDs

`POST /connector/list/by-ids`

## Request

- Base URL: `http://localhost:9090`
- URL: `http://localhost:9090/connector/list/by-ids`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/opencelium/apis/opencelium-api/docs/connector/list/by-ids/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- IdentifiersDTOInteger
  - `identifiers` integer[]

## Response `200`

Connectors have been successfully retrieved

- ConnectorResource[]
  - `connectorId` integer
  - `title` string
  - `description` string
  - `icon` string
  - `invoker` InvokerDTO
    - `name` string
    - `description` string
    - `hint` string
    - `icon` string
    - `authType` string
    - `requiredData` object
    - `operations` FunctionDTO[]
      - `name` string
      - `type` string
      - `request` RequestDTO
        - `id` string
        - `endpoint` string
        - `method` string
        - `header` object
        - `body` BodyDTO
          - `type` string
          - `format` string
          - `data` string
          - `fields` object
      - `response` ResponseDTO
        - `id` string
        - `name` string
        - `success` ResultDTO
          - `id` string
          - `status` string
          - `header` object
          - `body` BodyDTO
            - `type` string
            - `format` string
            - `data` string
            - `fields` object
        - `fail` ResultDTO
          - `id` string
          - `status` string
          - `header` object
          - `body` BodyDTO
            - `type` string
            - `format` string
            - `data` string
            - `fields` object
    - `hasManualSync` boolean
  - `sslCert` boolean
  - `timeout` integer
  - `requestData` object
  - `lastTestPassed` boolean
  - `lastTestError` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Error
- `502`: Bad Gateway

## Changes

> 3 revisions in range; 1 not diffed.

- **2026-07-30** `82ed767ffb65`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opencelium/apis/opencelium-api/changes/connector/list/by-ids/post.md)

---

[API](https://skmtc.dev/opencelium/apis/opencelium-api.md) - [All operations](https://skmtc.dev/opencelium/apis/opencelium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opencelium/apis/opencelium-api/revisions/82ed767ffb65?raw)