# Get a Team ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v2/teams/{team_id}: get: summary: Get a Team deprecated: false description: >- This endpoint allows the authenticated user to retrieve a specific team by team_id. Path Parameters: - team_id (int): The ID of the team to retrieve. Request Headers: - X-Authorization-Consistency-Token (string, optional): Authorization consistency token for read-after-write consistency. Pass the token received from a previous write operation to ensure this read reflects that write. Returns: - A response containing the team. Current Version: - 2.0.0 operationId: api_v2_teams_detail_retrieve tags: - Teams - Teams - v2 parameters: - name: team_id in: path description: The ID of the team required: true example: 0 schema: type: integer - name: Organization-Id in: header description: 'ID of the organization. Optional. ' required: false example: 0 schema: type: integer - name: Ocp-Apim-Subscription-Key in: header description: API KEY FOR EJENTO APIs required: true example: '{{your-api-key}}' schema: type: string default: '{{your-api-key}}' - name: Authorization in: header description: AUTH TOKEN example: Bearer {{your-access-token}} schema: type: string default: Bearer {{your-access-token}} responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/TeamDetailGetResponseSchema_V2' headers: {} x-apidog-name: OK '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/TeamDetailGet400ResponseSchema_V2' headers: {} x-apidog-name: Bad Request '403': description: >- The subscription key belongs to a different organization than the one this request names, or you do not have access to the organization it names. An organization that does not exist returns the same response. content: application/json: schema: type: object properties: success: type: boolean default: false message: type: string data: type: object default: {} x-apidog-orders: [] properties: {} x-apidog-ignore-properties: [] required: - success - message - data x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] headers: {} x-apidog-name: Record Not Found '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/TeamDetailGet404ResponseSchema_V2' headers: {} x-apidog-name: Server Error '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/TeamDetailGet500ResponseSchema_V2' headers: {} x-apidog-name: '' '503': description: >- The organization for this request could not be verified. Try again later. content: application/json: schema: type: object properties: success: type: boolean default: false message: type: string data: type: object default: {} x-apidog-orders: [] properties: {} x-apidog-ignore-properties: [] required: - success - message - data x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] headers: {} x-apidog-name: '' security: [] x-apidog-folder: Teams x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/998119/apis/api-19061324-run components: schemas: TeamDetailGetResponseSchema_V2: type: object properties: success: type: boolean message: type: string data: $ref: '#/components/schemas/TeamDetailGetResponseSerializer_V2' required: - success - message - data x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] x-apidog-folder: '' TeamDetailGetResponseSerializer_V2: type: object properties: id: type: integer readOnly: true created_by: type: string readOnly: true nullable: true modified_by: type: string readOnly: true nullable: true created_on: type: string format: date-time readOnly: true nullable: true modified_on: type: string format: date-time readOnly: true nullable: true team_name: type: string maxLength: 256 is_deleted: type: boolean parent: type: integer nullable: true org: type: integer required: - id - created_by - modified_by - created_on - modified_on - team_name - org x-apidog-orders: - id - created_by - modified_by - created_on - modified_on - team_name - is_deleted - parent - org x-apidog-ignore-properties: [] x-apidog-folder: '' TeamDetailGet400ResponseSchema_V2: type: object properties: success: type: boolean default: false message: type: string default: Bad Request data: type: object additionalProperties: type: string default: {} x-apidog-orders: [] properties: {} x-apidog-ignore-properties: [] x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] x-apidog-folder: '' TeamDetailGet404ResponseSchema_V2: type: object properties: success: type: boolean default: false message: type: string default: Not Found data: type: object additionalProperties: type: string default: {} x-apidog-orders: [] properties: {} x-apidog-ignore-properties: [] x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] x-apidog-folder: '' TeamDetailGet500ResponseSchema_V2: type: object properties: success: type: boolean default: false message: type: string default: Internal Server Error data: type: object additionalProperties: type: string default: {} x-apidog-orders: [] properties: {} x-apidog-ignore-properties: [] x-apidog-orders: - success - message - data x-apidog-ignore-properties: [] x-apidog-folder: '' securitySchemes: cookieAuth: type: apikey in: cookie name: sessionid oauth2: type: oauth2 flows: {} APIKeyHeader: type: apikey in: header name: X-API-Key OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: /api/login/access-token ejentoAuthKey: type: apikey in: header name: ejento-auth-key description: Server-to-server authentication key (EJENTO_SECRET / EJENTO_AUTH_KEY) Ocp-Apim-Subscription-Key: type: apikey in: header name: Ocp-Apim-Subscription-Key description: Subscription key. Required on every endpoint. Authorization: type: bearer scheme: bearer description: >- Your access token, sent as `Authorization: Bearer ` alongside the subscription key. Combination: group: - id: 619278 - id: 619279 type: combination servers: - url: https://{{your-server-name}} description: Prod Env security: [] ```