---
title: "Retrieves values from a specified range in a Google Sheet."
method: POST
path: "/getValues"
---

# Retrieves values from a specified range in a Google Sheet.

`POST /getValues`

This function fetches data from a designated range within a Google Sheet. It requires the sheet ID and the A1 notation of the range as input parameters. The function returns a promise that resolves to a two-dimensional array containing the values from the specified range, or an empty array if the range is empty.

## Request body

- object
  - `body` object — Body of the getValues sls call
    - `arguments` unknown[], required
      - unknown
    - `auth` object — Authentication object
      - `strategy` 'oauth2' — Authentication strategy
      - `variables` unknown[] — Variables for the authentication strategy
        - unknown
    - `packageName` string — @microfox/google-sheets

## Response `200`

Successful response

- array[] — A two-dimensional array containing the values in the specified range
  - string[]

## Other responses

- `400` — Bad Request - Invalid parameters
- `404` — Not Found - Sheet or range not found
- `500` — Internal Server Error

## Changes

- **2025-05-29** `470b95f73df9` — 1 breaking, 1 info
  - the `items/items/` response's property type/format changed from `any`/`` to `string`/`` for status `200`
  - added the non-success response with the status `404`
- **2025-05-28** `77260ff78232` — 1 breaking, 1 info
  - the `items/items/` response's property type/format changed from `string`/`` to `any`/`` for status `200`
  - removed the non-success response with the status `404`

[Change history](https://skmtc.dev/microfox-ai/apis/google-sheets-sdk-api/changes/getValues/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/google-sheets-sdk-api.md) · [All operations](https://skmtc.dev/microfox-ai/apis/google-sheets-sdk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/google-sheets-sdk-api/revisions/85db428f2808/schema)