---
title: "List Integration Auth"
method: GET
path: "/v1/integrations/{integrationId}/auth"
tags: ["Integration Auth"]
---

# List Integration Auth

`GET /v1/integrations/{integrationId}/auth`

Returns a paginated list of auth records for a given integration, sorted by most recently created first. Use the authType parameter to filter by credential type. Use page and size to navigate through results.

## Path parameters

- `integrationId` string, required

## Query parameters

- `authType` string
- `page` integer
- `size` integer

## Response `200`

OK

- PaginatedResponseIntegrationAuthResponse — Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` IntegrationAuthResponse[] — List of items for the current page. Contains up to 'size' number of records.
    - `authId` string — Unique identifier for the auth record
    - `integrationId` string — Unique identifier of the parent integration
    - `authType` 'NO_AUTH' | 'BASIC_AUTH' | 'BEARER_TOKEN' | 'API_KEY' — The authentication strategy this credential set uses. Determines which credential fields are required: API_KEY — provide the apiKey object (key name, secret value, and position). BEARER_TOKEN — provide the token field. BASIC_AUTH — provide username and password fields. NO_AUTH — no credential fields required.
    - `headers` object — Optional list of static HTTP headers attached to every outbound request under this auth. Applied on top of any headers defined at the integration or tool level. Useful for fixed metadata headers required by the third-party API.
    - `createdAt` string, date-time — Timestamp when the record was created
    - `updatedAt` string, date-time — Timestamp when the record was last updated
  - `page` integer — Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer — Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer — Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer — Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean — Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean — Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)