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

# Overview

> Learn how to create and send API requests in Requestly. Test APIs, configure requests, and view responses without writing code.

Requestly allows you to easily send API requests, without the need for writing code or using a terminal. It lets you test APIs, retrieve data, and explore how they work by simply creating a request, clicking Send, and viewing the response.

This is useful for developers testing API endpoints during development, QA engineers validating API responses for edge cases, and support engineers debugging API issues in real-time.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/2UzBlZe0aMI?si=fEvlazKw8Htapa9K" />

## Quick Start

Follow these steps to send your first API request:

<Steps>
  <Step title="Open API Client and Create a New Request">
    Open **Requestly Desktop App**, then click the `+ New` button to create a new request and select **Request** from the menu.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/send-api-request/fdef96c4-3da6-4a3a-a885-8999e89898f1.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=4563f3b2ffa03768b221d35772ada300" alt="The image shows the Requestly interface with the &#x22;New&#x22; button highlighted, displaying options: &#x22;Request,&#x22; &#x22;Collection,&#x22; and &#x22;Environment&#x22; in a dropdown menu." align="center" fullwidth="false" width="2400" height="1400" data-path="images/send-api-request/fdef96c4-3da6-4a3a-a885-8999e89898f1.png" />
  </Step>

  <Step title="Name Your API Request">
    Choose a descriptive title for your request to make it easy to identify later.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/send-api-request/23b0f1b3-f06c-411b-b329-6e0c2794170d.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=40601cee31d9f47df2c4b0f8e8fa12b9" alt="The image shows the Requestly interface's new request creation flow, with an input field for entering the request name, labeled 'Send API Request'" align="center" fullwidth="false" width="2400" height="1400" data-path="images/send-api-request/23b0f1b3-f06c-411b-b329-6e0c2794170d.png" />
  </Step>

  <Step title="Enter the API URL and HTTP Method">
    Pick the HTTP method (e.g., `GET`, `POST`) and type the URL of the API you want to test.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/send-api-request/b027f3b9-8d3c-49ee-9f5e-f7a66f7a5fd0.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=040b5ce27e5dc45a307dfb2d1a94737a" align="center" fullwidth="false" width="2400" height="831" data-path="images/send-api-request/b027f3b9-8d3c-49ee-9f5e-f7a66f7a5fd0.png" />
  </Step>

  <Step title="Save & Send the Request">
    Click the **Save** & **Send** button to execute your request.

    <img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/send-api-request/0143b46a-7adf-4483-bc4f-e81c8a6b1f0f.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=5959e770c8eabc947f2e7cffe5929e09" alt="The image shows the Requestly interface with a POST request to https://app.requestly.io/echo and the &#x22;Send&#x22; button towards the top right corner highlighted for executing the request." align="center" fullwidth="false" width="2400" height="1400" data-path="images/send-api-request/0143b46a-7adf-4483-bc4f-e81c8a6b1f0f.png" />
  </Step>
</Steps>

## Understanding the Response

Once you send a request, you'll see the response displayed in the bottom panel with the following information:

### View the Response Body

Check the response body in the **Response Body** section. You can switch between formatted (pretty) and raw views.

<img src="https://mintcdn.com/requestly/jpWr4YfnjW55tMhG/images/send-api-request/e258dee4-e903-417a-a847-1f1c7e438553.webp?fit=max&auto=format&n=jpWr4YfnjW55tMhG&q=85&s=4d07a874b947dcf9cf44131706cdf143" alt="Response Body - Send API Request" align="center" fullwidth="false" width="2400" height="1534" data-path="images/send-api-request/e258dee4-e903-417a-a847-1f1c7e438553.webp" />

Requestly renders the response based on its content type:

* **Text and structured data** (JSON, XML, HTML, plain text) shows in the editor. JSON and XML are pretty-printed in Preview, and the **Raw** toggle shows the response exactly as it came off the wire. For JSON, you can also [filter the response](/api-client/send-api-request/filter-json-response) to just the values you need using a JSONPath expression.
* **Images** (PNG, JPEG, WebP, GIF, SVG) render as the actual picture in Preview. Switch to **Raw** to see the underlying transported text.
* **Other binary content** (PDF, ZIP, audio, video, fonts, and similar) shows a **Binary response** placeholder with the response size, rather than unreadable characters. Switch to **Raw** to view the Base64-encoded body.

The **Size** shown for the response reflects the true byte count of the body, so it stays accurate for images and other binary responses.

<Frame>
  <img src="https://mintcdn.com/requestly/awCo8cGvGgr9Dk5X/images/response-image-preview.light.png?fit=max&auto=format&n=awCo8cGvGgr9Dk5X&q=85&s=9ef082a6ffecc75f25d1000998e441ce" alt="An image response rendered as a picture in the response body Preview" className="dark:hidden" width="1280" height="800" data-path="images/response-image-preview.light.png" />

  <img src="https://mintcdn.com/requestly/awCo8cGvGgr9Dk5X/images/response-image-preview.dark.png?fit=max&auto=format&n=awCo8cGvGgr9Dk5X&q=85&s=dda580d9b59ee26073e1660a268d3cbd" alt="An image response rendered as a picture in the response body Preview" className="hidden dark:block" width="1280" height="800" data-path="images/response-image-preview.dark.png" />
</Frame>

### Download the Response Body

To save a response to a file, click the **Download** button in the response pane header, next to **Save as example**.

<Frame>
  <img src="https://mintcdn.com/requestly/f2r_E8e82jmFFzoB/images/response-download-button.light.png?fit=max&auto=format&n=f2r_E8e82jmFFzoB&q=85&s=f2dd3d88d99dd881028c16f5b1d3b2cc" alt="The Download button in the HTTP response pane header, next to Save as example" className="dark:hidden" width="1280" height="800" data-path="images/response-download-button.light.png" />

  <img src="https://mintcdn.com/requestly/f2r_E8e82jmFFzoB/images/response-download-button.dark.png?fit=max&auto=format&n=f2r_E8e82jmFFzoB&q=85&s=5bb12eafa2bab058a676752883150aba" alt="The Download button in the HTTP response pane header, next to Save as example" className="hidden dark:block" width="1280" height="800" data-path="images/response-download-button.dark.png" />
</Frame>

Download works for both text and binary responses. Binary content (images, PDFs, fonts, and similar) is saved byte-for-byte, so the file you get is identical to what the server sent - the same response shown in the [preview above](#view-the-response-body).

### Check the Response Headers

Review the headers sent back by the server in the **Headers** tab.

<img src="https://mintcdn.com/requestly/C-8RNowaOOgmOMj9/images/send-api-request/3c04e205-9117-4730-b0e1-8a7c0379f4ce.png?fit=max&auto=format&n=C-8RNowaOOgmOMj9&q=85&s=4f41a9ac7f0690ecdb68ebfee376e8a5" alt="Response Headers - Send API Request" align="center" fullwidth="false" width="2400" height="1455" data-path="images/send-api-request/3c04e205-9117-4730-b0e1-8a7c0379f4ce.png" />

## Next Steps

Now that you understand the basics, explore these guides to master API request creation:

<CardGroup cols={2}>
  <Card title="Configure Request" icon="sliders" href="/api-client/send-api-request/create-requests/configure-request">
    Set up HTTP methods, URLs, and send your first request
  </Card>

  <Card title="Parameters and Body" icon="code" href="/api-client/send-api-request/create-requests/parameters-and-body">
    Add query parameters, path variables, and request body data
  </Card>

  <Card title="Request Headers" icon="list" href="/api-client/send-api-request/create-requests/request-headers">
    Configure headers for authentication and content types
  </Card>
</CardGroup>
