---
title: "Poll For Result Using Function Invocation Request"
method: GET
path: "/v2/nvcf/pexec/status/{requestId}"
tags: ["Function Invocation"]
---

# Poll For Result Using Function Invocation Request

`GET /v2/nvcf/pexec/status/{requestId}`

Retrieves the status of an in-progress or pending request using its unique  invocation request ID. If the result is available, it will be included in  the response, marking the request as fulfilled. Conversely, if the result is  not yet available, the request is deemed pending. Access to this endpoint  mandates inclusion of either a bearer token or an api-key with  'invoke_function' scope in the HTTP Authorization header. In-progress responses are returned in order. If no in-progress response is received  during polling you will receive the most recent in-progress response. Only the first  256 unread in-progress messages are kept.

## Path parameters

- `requestId` string, uuid, required

## Headers

- `NVCF-POLL-SECONDS` integer

## Response `200`

Invocation is fulfilled

- object
  - `short` integer
  - `char` string
  - `int` integer
  - `long` integer
  - `float` number, float
  - `double` number, double
  - `direct` boolean
  - `readOnly` boolean

## Other responses

- `202` — Result is pending. Client should poll using the requestId.
- `302` — Client should use the URL specified in the 'Location' response header to fetch large result.
- `402` — Cloud credits expired for public functions. Please contact NVIDIA representatives.
- `403` — Either missing scope in the auth(SSA JWT / SAK) token and/or missing resource entry in the SAK for the function.

---

[API](https://skmtc.dev/brevdev/apis/cloud-functions.md) · [All operations](https://skmtc.dev/brevdev/apis/cloud-functions/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brevdev/cloud-functions/revisions/add37b001ffc/schema)