---
title: "Get forward request"
method: GET
path: "/forward/{id}"
tags: ["Forward"]
---

# Get forward request

`GET /forward/{id}`

## Request

- Base URL: `https://forward.checkout.com`
- URL: `https://forward.checkout.com/forward/{id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `forward`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/forward/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details of a successfully forwarded API request.    

The details can be retrieved for up to 14 days after the request was initiated.

## Path parameters

- `id` string, required

## Response `200`

Forward request retrieved successfully

- GetForwardRequestResponse: The response to the forward request.
  - `request_id` string, required: The unique identifier for the forward request.
  - `reference` string: The unique reference for the forward request.
  - `entity_id` string, required: The client entity linked to the forward request.
  - `destination_request` GetForwardRequestDestinationRequest, required: The details of the request to forward.
    - `url` string, required: The URL of the forward request.
    - `method` string, required: The HTTP method of the forward request.
    - `headers` object, required: The HTTP headers of the forward request. Encrypted and sensitive header values are redacted.
    - `body` string, required: The HTTP message body of the forward request. This is the original value used to initiate the request, with placeholder value text included. For example, `{{card_number}}` is not replaced with an actual card number.
  - `destination_response` GetForwardRequestDestinationResponse: The response returned by the third-party endpoint the forward request was sent to.
    - `status` number, required: The HTTP status code returned with the destination response.
    - `headers` object, required: The destination response's HTTP headers.
    - `body` string, required: The destination response's HTTP message body.
  - `created_on` string, date-time, required: The date and time the forward request was created, in UTC.

## Other responses

- `401`: Unauthorized
- `404`: Forward request not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)