# Get one step result with its run, evidence, Form provenance, comments, telemetry, and Activity outcome.

Get one step result with its run, evidence, Form provenance, comments, telemetry, and Activity outcome.

Canonical: https://commentary.dev/docs/reference/api/get-research-workflow-step-v2

`GET /api/v2/research-studies/{studyId}/sessions/{sessionId}/steps/{stepId}`

Get one step result with its run, evidence, Form provenance, comments, telemetry, and Activity outcome.

## Access

Use a credential with `commentary.research.read`.

Provider access, workspace membership, and agent grants are enforced separately. A token does not expand access to a repository or resource. [Set up developer access](/docs/build/developer-access).

## Parameters

| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `studyId` | path | string | Yes | Research Study id. |
| `sessionId` | path | string | Yes | Draft review or Research session id. |
| `stepId` | path | string | Yes | Research workflow step id. |

## Call the endpoint

Replace path placeholders and your credential. For body operations, create `request.json` using the required fields above; this command does not invent resource identifiers or consent.

```bash
curl --request GET \
  'https://commentary.dev/api/v2/research-studies/<studyId>/sessions/<sessionId>/steps/<stepId>' \
  --header 'Authorization: Bearer <your-token>'
```

## Responses

| Status | Meaning | Payload |
| --- | --- | --- |
| `200` | Successful response. | object |
| `400` | The request was invalid. | [ExternalError](/docs/reference/schemas/external-error) |
| `401` | Authentication is required. | [ExternalError](/docs/reference/schemas/external-error) |
| `403` | The token or session does not have permission for this resource. | [ExternalError](/docs/reference/schemas/external-error) |
| `404` | The resource was not found. | [ExternalError](/docs/reference/schemas/external-error) |
| `429` | The request was rate limited. | [ExternalError](/docs/reference/schemas/external-error) |

### Successful response fields

Value type: object.

## Recover from errors

Use the returned status and error body. Correct invalid fields before retrying; reconnect or narrow the target for authentication and permission errors. For conditional writes, reload the latest version before preparing a new request. Respect rate-limit headers and retry only when the operation’s idempotency contract permits it.

## Contract and related guidance

Operation ID: `getResearchWorkflowStepV2`. [Download the OpenAPI contract](/docs/reference/openapi.json) for complete constraints and code generation. [Browse endpoints](/docs/reference/api-operations).