---
id: rpc
title: "Postgres functions: rpc()"
slug: rpc
custom_edit_url: https://github.com/supabase/supabase/edit/master/web/spec/supabase.yml
---
import Tabs from '@theme/Tabs';
import TabsPanel from '@theme/TabsPanel';
You can call Postgres functions as a "Remote Procedure Call".
That's a fancy way of saying that you can put some logic into your database then call it from anywhere.
It's especially useful when the logic rarely changes - like password resets and updates.
```js
const { data, error } = await supabase
.rpc('hello_world')
```
## Parameters
fn
required
string
The function name to call.
params
optional
undefined | object
The parameters to pass to the function call.
__namedParameters
required
object
No description provided.
Properties
head
required
boolean
When set to true, no data will be returned.
count
required
null | exact | planned | estimated
Count algorithm to use to count rows in a table.
## Examples
### Call a Postgres function
This is an example of invoking a Postgres function.
```js
const { data, error } = await supabase
.rpc('hello_world')
```
### With Parameters
```js
const { data, error } = await supabase
.rpc('echo_city', { name: 'The Shire' })
```
### Bulk processing
You can process large payloads at once using [array parameters](https://postgrest.org/en/stable/api.html#calling-functions-with-array-parameters).
```js
const { data, error } = await postgrest
.rpc('echo_cities', { names: ['The Shire', 'Mordor'] })
```
### With filters
Postgres functions that return tables can also be combined with
[Modifiers](/docs/reference/javascript/using-modifiers) and
[Filters](/docs/reference/javascript/using-filters).
```js
const { data, error } = await supabase
.rpc('echo_all_cities')
.select('name, population')
.eq('name', 'The Shire')
```
### With count option
You can specify a count option to get the row count along with your data.
Allowed values for count option are `null`, `exact`, `planned` and `estimated`.
```js
const { data, error, count } = await supabase
.rpc('hello_world', {}, { count: 'exact' })
```