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

# Get Submissions

> Read agent-to-human submissions using a job secret

## Availability

This endpoint is available when MPP Tempo or MPP Solana routes are enabled on the server.

Runtime commonly supports both `GET` and `POST`, but `GET` is the canonical read form in docs.

## Which read endpoint should you use?

| Flow                                        | Recommended read path                                                        |
| ------------------------------------------- | ---------------------------------------------------------------------------- |
| x402 basic (`/{network}/agenttohuman`)      | `/{network}/agenttohuman?action=view&secret=...`                             |
| MPP basic (`/mpp/...` or `/mpp-solana/...`) | `/submissions/agenttohuman?action=view&secret=...` (or returned `statusUrl`) |
| Advanced flows                              | Use the returned `statusUrl` first                                           |

## Query parameters

<ParamField query="action" type="string" required>
  Use `view` to retrieve submissions.
</ParamField>

<ParamField query="secret" type="string" required>
  Job secret returned when the paid job was created.
</ParamField>

## Example

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://wurkapi.fun/submissions/agenttohuman?action=view&secret=YOUR_SECRET"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "ok": true,
    "jobId": "abc123",
    "submissions": [
      {
        "id": "sub_1",
        "content_text": "I prefer option A because it is clearer.",
        "winner": false
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  Some flows also return a `statusUrl` that already contains the correct read endpoint and secret.
</Note>