---
title: "Club roster CSV template"
method: GET
path: "/api/admin/teams/{teamId}/roster/template"
tags: ["Admin", "Teams"]
---

# Club roster CSV template

`GET /api/admin/teams/{teamId}/roster/template`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/teams/{teamId}/roster/template`
- Auth: HTTP bearer

Same canManageTeam gate. Default response is text/csv attachment club-roster-template.csv. ?format=json or Accept: application/json returns { success, data: { filename, csv } }. Header: id,name,jerseyNumber,position,status,signedAt,departedAt.

## Path parameters

- `teamId` string, required

## Query parameters

- `format` 'json'

## Response `200`

text/csv file, or { success, data: { filename, csv } } when format=json

## Other responses

- `401`: { success: false, error, code: UNAUTHORIZED }
- `403`: { success: false, error, code: FORBIDDEN }
- `404`: { success: false, error, code: NOT_FOUND }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/teams/:teamId/roster/template/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
