---
title: "Check Team API Key"
description: "Validate a team API key and check if it is currently active."
api: "POST /api/v1/team-api-keys/check"
---

## Request

<ParamField header="x-stack-secret-server-key" type="string" required>
  The secret server key for authentication.
</ParamField>

<ParamField header="x-stack-project-id" type="string" required>
  The project ID.
</ParamField>

<ParamField body="api_key" type="string" required>
  The team API key value to validate.
</ParamField>

## Response

<ResponseField name="is_valid" type="boolean">
  Whether the API key is valid and active.
</ResponseField>

<ResponseField name="id" type="string">
  The unique identifier of the API key, if valid.
</ResponseField>

<ResponseField name="team_id" type="string">
  The identifier of the team the API key belongs to, if valid.
</ResponseField>

<CodeGroup>
```bash cURL
curl -X POST 'https://api.stack-auth.com/api/v1/team-api-keys/check' \
  -H 'Content-Type: application/json' \
  -H 'x-stack-secret-server-key: YOUR_SECRET_SERVER_KEY' \
  -H 'x-stack-project-id: YOUR_PROJECT_ID' \
  -d '{
    "api_key": "tak_live_abc123def456..."
  }'
```

```json 200 Response
{
  "is_valid": true,
  "id": "tak_1234567890",
  "team_id": "team_1234567890"
}
```
</CodeGroup>