> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/integration/get.md).

# GET

GET calls an HTTP endpoint and stores the response for later steps. Use it to read data from an API inside the same Flow as your browser steps.

For a walkthrough of auth Headers, storage names, and JSON asserts, see [Test APIs in a Flow](/guides/test-apis-in-a-flow.md).

![GET Test Step](https://app.does.qa/screenshots/node/integration_api_get.png)

## When to use it

* Fetch a resource before or after a UI action.
* Store the body under a clear **Response Storage Name**, then assert with [Check JSON Value](/test-steps/check/check-json-value.md).

## Configure

### Basics

| Field                     | What to set                                                                   |
| ------------------------- | ----------------------------------------------------------------------------- |
| **URL**                   | Fully qualified URL, or a [Value](/values/value-store.md) that expands to one |
| **Response Storage Name** | Name for the stored response (`response` by default)                          |

### Advanced

| Field                              | What to set                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Headers**                        | Request headers as JSON (use for Bearer tokens and API keys)                                   |
| **Expected Response Status Codes** | Defaults to `2xx`. Add specific codes when needed. Responses in the `5xx` range fail as errors |
| **Response Object**                | `Body` (default), `Headers`, or `Complete`                                                     |
| **Status on fail**                 | [Failed Status](/test-step-options/failed-status.md)                                           |

{% hint style="info" %}
**Pro tip:** Switch **Method** on the step to move between GET, POST, PUT, PATCH, and DELETE without rebuilding the rest of the configuration.
{% endhint %}

## Related

* [POST](/test-steps/integration/post.md)
* [PUT](/test-steps/integration/put.md)
* [PATCH](/test-steps/integration/patch.md)
* [DELETE](/test-steps/integration/delete.md)
* [Test APIs in a Flow](/guides/test-apis-in-a-flow.md)
* [Integration](/test-steps/integration.md)

**Tags:** `integration`, `api`, `get`, `rest`
