---
title: "Call read-only function"
method: POST
path: "/v2/contracts/call-read/{contract_address}/{contract_name}/{function_name}"
tags: ["Smart Contracts"]
---

# Call read-only function

`POST /v2/contracts/call-read/{contract_address}/{contract_name}/{function_name}`

Call a read-only public function on a given smart contract.

The smart contract and function are specified using the URL path. The arguments and the simulated tx-sender are supplied via the POST body in the following JSON format:

## Path parameters

- `contract_address` string, required
- `contract_name` string, required
- `function_name` string, required

## Query parameters

- `tip` string

## Request body

- ReadOnlyFunctionArgsSchemaJson — unresolved $ref

## Response `200`

Success

- PostCallReadOnlyFnSchemaJson — unresolved $ref

## Changes

- **2021-12-01** `09258b775c7a` — 1 warning
  - deleted the `query` request parameter `use_latest_tip`
- **2021-11-17** `f936683f3e46` — 1 info
  - added the new optional `query` request parameter `use_latest_tip`
- **2021-10-13** `aef805fa1fb4` — 1 warning
  - deleted the `query` request parameter `use_latest_tip`
- **2021-07-29** `40964fcc538a` — 1 breaking
  - for the `query` request parameter `use_latest_tip`, the type/format was changed from `string`/`` to `boolean`/``
- **2021-07-23** `df3a58543ff9` — 1 info
  - added the new optional `query` request parameter `use_latest_tip`

[Change history](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/changes/v2/contracts/call-read/:contract_address/:contract_name/:function_name/post.md)

---

[API](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api.md) · [All operations](https://skmtc.dev/hirosystems/apis/stacks-2-0-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hirosystems/stacks-2-0-rpc-api/revisions/7a7617c2d7cc/schema)