> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a team

> Get team details and member list. Caller must be an accepted member.

Get team details and the member list. Caller must be an accepted member. Returns the caller's role so the client can branch UI on permissions.

```bash theme={null}
curl -X GET https://app.dacard.ai/api/teams/tm_2x1B3y \
  -H "Authorization: Bearer $DACARD_API_KEY"
```

| Property           | Value                                          |
| ------------------ | ---------------------------------------------- |
| **Auth**           | Required                                       |
| **Required scope** | Caller must have `status: accepted` membership |
| **Idempotent**     | Yes                                            |

## Response

```json theme={null}
{
  "team": {
    "id": "tm_2x1B3y...",
    "name": "Acme Product",
    "createdAt": "2026-04-12T18:11:43Z"
  },
  "members": [
    {
      "id": "tmm_...",
      "userId": "user_...",
      "email": "founder@acme.com",
      "role": "admin",
      "status": "accepted",
      "functionScope": null
    }
  ],
  "currentRole": "admin"
}
```

## Errors

| Status | Code                | When                                             |
| ------ | ------------------- | ------------------------------------------------ |
| 401    | `AUTH_REQUIRED`     | No session.                                      |
| 403    | `Not a team member` | Caller has no accepted membership for this team. |
| 404    | `Team not found`    | Bad `id`.                                        |
| 500    | `INTERNAL_ERROR`    | Read failed.                                     |