# Get Team Card (/reference-api/schema/a2a/get-team-card)

## Runtime contract [#runtime-contract]

The generated response schema is unspecified. This route returns an A2A Agent Card directly, with the fields described below.

Start the [example A2A server](/reference-api/schema/a2a/run-message-agent#example-server) and set the same `OS_SECURITY_KEY` in the client terminal. These examples target `reference-team` on port 7777. On deployments using scoped bearer authorization, this operation requires `teams:read` (or a matching broader grant). The authenticated principal determines user identity; `X-User-ID` is only anonymous attribution and cannot override it.

```bash
curl "http://localhost:7777/a2a/teams/reference-team/.well-known/agent-card.json" \
  -H "Authorization: Bearer $OS_SECURITY_KEY"
```

The response includes `name`, `description`, `url`, `version`, `protocolVersion`, `capabilities`, `defaultInputModes`, `defaultOutputModes`, and `skills`. Optional fields may be null. It is not wrapped in a JSON-RPC `result`. Card metadata is a discovery description; it does not grant permission to execute the component.

## `GET /a2a/teams/{id}/.well-known/agent-card.json`

**Summary:** Get Team Card

### Authentication

Not specified.

### Parameters
- `id` (path; string; required)

### Request body

None.

### Responses

#### `200`

Successful Response

**`application/json`**

Type `unspecified`.

#### Other responses

- `422` — Validation Error `application/json`: Schema `HTTPValidationError` (object).