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

# Get Team Meta

> Returns lightweight metadata for a team, including its name, member cap, and default plan.

# Get Team Meta

Returns a minimal metadata object for a team identified by its GUID. Used during checkout flows to resolve team details without loading the full profile — for example, to display the team name and validate member limits when signing up for a tariff.

## Authentication

Requires a valid customer bearer token.

## Path Parameters

<ParamField path="teamGuidId" type="string" required>
  The team's UUID (`UniqueId`). Returned as `UniqueId` from [`GET /api/public/teams/my`](/api/endpoints/teams/list-teams).
</ParamField>

## Query Parameters

<ParamField query="_shape" type="string">
  Comma-separated list of field paths to include in the response. When provided, only the
  specified fields are returned — useful for reducing payload size. Supports nested paths
  using dot notation.
</ParamField>

## Response

Returns a flat object with core team metadata.

<ResponseField name="Id" type="number" required>
  Numeric identifier for the team.
</ResponseField>

<ResponseField name="Name" type="string" required>
  Display name of the team.
</ResponseField>

<ResponseField name="MaxTeamMemberCount" type="number">
  Maximum allowed members. `0` or absent means unlimited.
</ResponseField>

<ResponseField name="Tariff" type="object | undefined">
  The team's default membership plan, if one is assigned.
</ResponseField>

<ResponseField name="Tariff.Id" type="number">
  Numeric identifier of the default plan.
</ResponseField>

<ResponseField name="Tariff.UniqueId" type="string">
  UUID of the default plan.
</ResponseField>

<ResponseField name="Tariff.Name" type="string">
  Display name of the default plan.
</ResponseField>

## Examples

### Fetch team meta by GUID

```http theme={null}
GET /api/public/teams/a1b2c3d4-e5f6-7890-abcd-ef1234567890/meta
Authorization: Bearer {token}
```

```json theme={null}
{
  "Id": 55,
  "Name": "Tech Innovators",
  "MaxTeamMemberCount": 20,
  "Tariff": {
    "Id": 301,
    "UniqueId": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "Name": "Team Professional"
  }
}
```

## TypeScript Integration

```typescript theme={null}
import { endpoints } from '@/api/endpoints'

const endpoint = endpoints.teams.meta(teamGuidId)
const { data } = await httpClient.get<typeof endpoint.type>(endpoint.url)
```

## Usage in Portal

| Context                              | Source file                                     |
| ------------------------------------ | ----------------------------------------------- |
| Tariff signup step (`/checkout/...`) | `src/views/checkout/steps/TariffSignupStep.tsx` |

## Error Responses

<ResponseField name="401 Unauthorized" type="error">
  The customer is not authenticated or the session has expired.
</ResponseField>

<ResponseField name="404 Not Found" type="error">
  No team exists with the specified GUID.
</ResponseField>

## Related Endpoints

| Method | Endpoint                             | Description               |
| ------ | ------------------------------------ | ------------------------- |
| `GET`  | `/api/public/teams/my`               | List the customer's teams |
| `GET`  | `/api/public/teams/{teamId}/profile` | Full team profile         |
| `GET`  | `/api/public/teams/{teamId}/kpi`     | Team KPI metrics          |