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

# Get verification session status

> Returns instant status, or waits up to 25 seconds when the optional wait query is provided.



## OpenAPI

````yaml /api/openapi.json get /api/v1/verify/session/{sid}
openapi: 3.1.0
info:
  title: Dock API
  description: >-
    API for managing links between Roblox and Discord accounts, including
    mapping, updating, removing links, and resetting the custom database.
  version: 1.0.0
servers:
  - url: https://api.docksys.xyz
security:
  - bearerAuth: []
paths:
  /api/v1/verify/session/{sid}:
    get:
      summary: Get verification session status
      description: >-
        Returns instant status, or waits up to 25 seconds when the optional wait
        query is provided.
      parameters:
        - name: sid
          in: path
          required: true
          schema:
            type: string
          description: Verification session identifier.
        - name: wait
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 25
          description: Optional long-poll wait time in seconds.
      responses:
        '200':
          description: Current verification session state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VerifySessionStatusResponse'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Session not found or not owned by this API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Poll too frequent, poll cap reached, or verify quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    VerifySessionStatusResponse:
      type: object
      properties:
        status:
          type: integer
          enum:
            - 200
        data:
          oneOf:
            - type: object
              properties:
                sid:
                  type: string
                pid:
                  type: string
                status:
                  type: string
                  enum:
                    - pending
                    - expired
                    - cancelled
                result:
                  type: 'null'
            - type: object
              properties:
                sid:
                  type: string
                pid:
                  type: string
                result:
                  type: object
                  properties:
                    discordId:
                      type: string
                      nullable: true
                    robloxId:
                      type: string
                      nullable: true
                    linkChanged:
                      type: boolean
                      nullable: true
                    previousRobloxId:
                      type: string
                      nullable: true
        timestamp:
          type: string
          format: date-time
        version:
          type: string
        verifyRequestsRemaining:
          type: integer
          nullable: true
        verifyIpRequestsRemaining:
          type: integer
          nullable: true
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          enum:
            - 400
            - 401
            - 403
            - 404
            - 500
          description: The HTTP status code of the error response.
        error:
          type: string
          description: A message describing the error.
        timestamp:
          type: string
          format: date-time
          description: The timestamp of the response in ISO 8601 format.
        version:
          type: string
          example: 1.0.0
          description: The API version.
        requestsRemaining:
          type: integer
          nullable: true
          description: Number of requests remaining in the daily quota.
        ipRequestsRemaining:
          type: integer
          nullable: true
          description: >-
            Remaining IP-linked quota shared across API keys detected on the
            same IP.
    RateLimitErrorResponse:
      type: object
      properties:
        status:
          type: integer
          enum:
            - 429
          description: The HTTP status code of the rate limit error response.
        error:
          type: string
          description: A message describing the rate limit error.
        timestamp:
          type: string
          format: date-time
          description: The timestamp of the response in ISO 8601 format.
        version:
          type: string
          example: 1.0.0
          description: The API version.
        retryAfter:
          type: integer
          description: Seconds until the rate limit resets or the next request can be made.
        requestsRemaining:
          type: integer
          nullable: true
          description: Number of requests remaining in the daily quota.
        ipRequestsRemaining:
          type: integer
          nullable: true
          description: >-
            Remaining IP-linked quota shared across API keys detected on the
            same IP.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````