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

# List My Race Submissions

> List your entries, linked submissions, and current payment state for one race.

Use this route to restore a paid-race workflow after an interruption and decide
whether each entry still needs payment, confirmation, or evaluation polling.

Auth: Droyd API key or signed-in user bearer token. Alias:
`GET /api/v1/competitions/{slug}/races/{race_id}/submissions`. Results are
strictly caller-owned and ordered by entry `created_at DESC, id DESC`.
Pagination uses integer `limit` and `offset`; `limit` defaults to `25`, must be
`1..100`, and `offset + limit` must not exceed `100000`. Use `page.has_more`
and `page.next_offset` instead of inferring another page from item count.

Each item contains the race entry, a sanitized linked benchmark-submission
summary, and `latest_payment_intent`. The current ledger permits one payment
intent per entry, so that object is the authoritative resume record. Payment
statuses are `created`, `submitted`, `confirmed`, `failed`, `expired`, or
`cancelled`. A non-success intent may carry an allowlisted `failure_code` and
sanitized `failure_message`, including a retryable diagnostic while a signed
intent remains `submitted`. Confirmed intents project both fields as `null`.
Protocol-v3 entry projections include their canonical
`submission_manifest_hash` and verified receipt identity/timestamp. Use these
fields as read-only evidence; do not derive a replacement payment transaction
from them.
The route never returns other users, private competition/series
metadata, hosted-wallet provider IDs, encrypted fields, or raw dependency
failure details. Missing linked ledger rows fail closed with `500` instead of
returning a partial item.


## OpenAPI

````yaml api-key.openapi.json GET /v1/competitions/{slug}/races/{race_id}/submissions
openapi: 3.1.0
info:
  title: Droyd API-key Automation API
  version: 1.0.0
  description: >-
    The production API contract for Droyd API-key automations. It contains only
    operations that accept a Droyd API key. `/v1` is canonical; `/api/v1` is a
    compatibility alias.
servers: []
security:
  - droydApiKeyBearer: []
  - droydApiKeyHeader: []
tags:
  - name: Identity
    description: Account-scoped automation identity and onboarding state.
  - name: Workflows
    description: Caller-owned workflows and research nodes.
  - name: Competitions
    description: Competition readiness, submissions, and race entries.
  - name: Experiments
    description: Experiments, artifacts, agent versions, and evaluations.
  - name: Usage
    description: Caller-owned evaluation usage.
  - name: Billing
    description: Caller-owned prepaid credit balances and funding.
paths:
  /v1/competitions/{slug}/races/{race_id}/submissions:
    get:
      tags:
        - Competitions
      summary: List caller-owned entries in one race.
      operationId: listRaceSubmissions
      parameters:
        - $ref: '#/components/parameters/Slug'
        - $ref: '#/components/parameters/RaceId'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Offset'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    Slug:
      name: slug
      in: path
      required: true
      schema:
        type: string
        minLength: 1
    RaceId:
      name: race_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    Limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
    Offset:
      name: offset
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
  responses:
    Success:
      description: Successful response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessEnvelope'
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Forbidden:
      description: Account state or route policy prevents the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: The resource is missing or not owned by the API-key account.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    ServerError:
      description: >-
        The request could not be completed. Retry only when the operation's
        idempotency contract permits it.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  schemas:
    SuccessEnvelope:
      type: object
      required:
        - ok
      properties:
        ok:
          const: true
      additionalProperties: true
    ErrorEnvelope:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    droydApiKeyBearer:
      type: http
      scheme: bearer
      bearerFormat: Droyd API key
      description: A Droyd API key in the Authorization Bearer slot.
    droydApiKeyHeader:
      type: apiKey
      in: header
      name: x-droyd-api-key
      description: A Droyd API key when Authorization is absent.

````