---
title: "List BYOK credentials"
method: GET
path: "/ai-gateway/byok-credentials/list"
tags: ["ai-gateway"]
---

# List BYOK credentials

`GET /ai-gateway/byok-credentials/list`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/ai-gateway/byok-credentials/list`
- Auth: HTTP bearer

List BYOK credentials for an owner, optionally filtered by provider

## Query parameters

- `ownerId` string: The owner ID to list credentials for. Ignored for customer tokens, which always list their own team.
- `providerSlug` string: Optional provider slug to filter credentials by
- `includeDeleted` 'true' | 'false': Whether to include soft-deleted credentials
- `decrypt` 'true' | 'false': Not supported. Credential values are never returned.
- `includeModelMappings` 'true' | 'false': Whether to include model mappings for each credential in the response
- `teamId` string
- `slug` string

## Response `200`

- object
  - `credentials` object[], required
    - `active` false | true, required
    - `createdAt` number, required
    - `credential` string, nullable, required
    - `credentialId` string, required
    - `deleted` false | true, required
    - `lastFourChars` string, required
    - `modelMappings` object[], required
      - `customModelId` string, required
      - `gatewayModelSlug` string, required
    - `name` string, required
    - `ownerId` string, required
    - `providerSlug` string, required
    - `rotatedAt` number, nullable, required
    - `updatedAt` number, required
    - `zeroDataRetention` false | true, required

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`
- `500`

## Changes

- **2026-10-29** `4966aebe003c`: 1 info
  - added the required property `credentials/items/rotatedAt` to the response with the `200` status
- **2026-10-27** `ef8042371d97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/ai-gateway/byok-credentials/list/get.md)

---

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