---
title: "Get precomputations (apps)"
method: GET
path: "/rest/api/3/jql/function/computation"
tags: ["JQL functions (apps)"]
---

# Get precomputations (apps)

`GET /rest/api/3/jql/function/computation`

Returns the list of a function's precomputations along with information about when they were created, updated, and last used. Each precomputation has a `value` \- the JQL fragment to replace the custom function clause with.

**[Permissions](#permissions) required:** This API is only accessible to apps and apps can only inspect their own functions.

The new `read:app-data:jira` OAuth scope is 100% optional now, and not using it won't break your app. However, we recommend adding it to your app's scope list because we will eventually make it mandatory.

## Query parameters

- `functionKey` string[]
- `startAt` integer
- `maxResults` integer
- `orderBy` string

## Response `200`

Returned if the request is successful.

- PageBean2JqlFunctionPrecomputationBean — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` JqlFunctionPrecomputationBean[] — The list of items.
    - `arguments` string[] — The list of arguments function was invoked with.
    - `created` string, date-time — The timestamp of the precomputation creation.
    - `error` string — The error message to be displayed to the user.
    - `field` string — The field the function was executed against.
    - `functionKey` string — The function key.
    - `functionName` string — The name of the function.
    - `id` string — The id of the precomputation.
    - `operator` string — The operator in context of which function was executed.
    - `updated` string, date-time — The timestamp of the precomputation last update.
    - `used` string, date-time — The timestamp of the precomputation last usage.
    - `value` string — The JQL fragment stored as the precomputation.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the request is not authenticated as the app that provided the function.
- `404` — Returned if the function is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)