---
title: "Get a single board square"
url: "https://dev-portal-nov11.movespot.fyi/apis/tic-tac-toe-1-0-0/versions/1756fa82-c2da-4b9a-81c8-4b53c7dbf566/operations/get-square"
---

> Full API specification: https://dev-portal-nov11.movespot.fyi/apis/tic-tac-toe-1-0-0/versions/1756fa82-c2da-4b9a-81c8-4b53c7dbf566.md

# Get a single board square

`GET` `/board/{row}/{column}`

Operation ID: `get-square`

Retrieves the requested square.

## Path parameters

- `row` (integer, required) - Board row (vertical coordinate)
- `column` (integer, required) - Board column (horizontal coordinate)

## Responses

- `200` - OK
- `400` - The provided parameters are incorrect

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Tic Tac Toe
  version: 1.0.0
paths:
  /board/{row}/{column}:
    parameters:
      - $ref: "#/components/parameters/rowParam"
      - $ref: "#/components/parameters/columnParam"
    get:
      summary: Get a single board square
      description: Retrieves the requested square.
      tags:
        - Gameplay
      operationId: get-square
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/mark"
        "400":
          description: The provided parameters are incorrect
          content:
            text/html:
              schema:
                $ref: "#/components/schemas/errorMessage"
              example: Illegal coordinates
      security:
        - bearerHttpAuthentication: []
        - user2AppOauth:
            - board:read
security:
  - bearerHttpAuthentication: []
  - user2AppOauth:
      - board:read
components:
  parameters:
    rowParam:
      description: Board row (vertical coordinate)
      name: row
      in: path
      required: true
      schema:
        $ref: "#/components/schemas/coordinate"
    columnParam:
      description: Board column (horizontal coordinate)
      name: column
      in: path
      required: true
      schema:
        $ref: "#/components/schemas/coordinate"
  schemas:
    mark:
      type: string
      enum:
        - .
        - X
        - O
      description: Possible values for a board square. `.` means empty square.
      example: .
    errorMessage:
      type: string
      maxLength: 256
      description: A text message describing an error
    coordinate:
      type: integer
      minimum: 1
      maximum: 3
      example: 1
  securitySchemes:
    bearerHttpAuthentication:
      description: Bearer token using a JWT
      type: http
      scheme: Bearer
      bearerFormat: JWT
    user2AppOauth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://learn.openapis.org/oauth/2.0/auth
          tokenUrl: https://learn.openapis.org/oauth/2.0/token
          scopes:
            board:read: Read the board
            board:write: Write to the board
```
