# Response Format

## JSON vs CSV Response

The API supports JSON and CSV return formats. The default return format is JSON. JSON is generally easier to work with in code, while CSV is more suitable for downloading the data to a spreadsheet or other data analysis tools.

You can specify the return format by adding the `return_format` query parameter to your request. For example, to get the data in CSV format, you would add `?return_format=csv` to the end of your request.

#### JSON <a href="#json" id="json"></a>

There are two JSON return formats: `array_of_objects` and `array_of_arrays`. The `array_of_objects` format is the default format. The `array_of_arrays` format is useful for minimizing the size of the response.

#### CSV <a href="#csv" id="csv"></a>

The CSV return format is useful for downloading the data to a spreadsheet.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gridstatus.io/developers/concepts/response-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
