---
title: "List integration key services"
method: GET
path: "/v1/integrations/key_services"
tags: ["Integrations key service"]
---

# List integration key services

`GET /v1/integrations/key_services`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/integrations/key_services`
- Auth: HTTP bearer

Returns a paginated list of the available integration services that keys can be
created against (e.g. an ERP or the SII). Each service describes how a key must
authenticate (`auth_method`, `identifier_type`). Visible to any authenticated user.

This is a distinct collection from `/v1/integrations/keys` (the stored credentials).

Supports `_start`/`_end` pagination, `_field`/`_order` sorting, and per-field filters.

## Query parameters

- `auth_method` 'token' | 'password'

## Parameters

- `#/paths/~1v1~1bills/get/parameters/0` (unresolved $ref)
- `#/paths/~1v1~1bills/get/parameters/1` (unresolved $ref)
- `#/paths/~1v1~1bills/get/parameters/2` (unresolved $ref)
- `#/paths/~1v1~1bills/get/parameters/3` (unresolved $ref)
- `#/paths/~1v1~1bills/get/parameters/4` (unresolved $ref)

## Response `200`

Paginated list of integration key services.

- IntegrationsKeyService[]
  - `id` string, required
  - `name` string, required
  - `auth_method` 'token' | 'password', required
  - `identifier_type` string, nullable
  - `image_url` string, nullable
  - `description` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized - missing or invalid authentication token.

---

[API](https://skmtc.dev/cardda/apis/finance-api.md) - [All operations](https://skmtc.dev/cardda/apis/finance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/finance-api/revisions/59752c65ea74?raw)