---
title: "List all ForwardingRequests"
method: GET
path: "/v1/forwarding/requests"
---

# List all ForwardingRequests

`GET /v1/forwarding/requests`

Lists all ForwardingRequest objects.

## Query parameters

- `created` object
  - `gt` integer
  - `gte` integer
  - `lt` integer
  - `lte` integer
- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string

## Response `200`

Successful response.

- object — List of ForwardingRequest data.
  - `data` ForwardingRequest[], required
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `metadata` object, nullable — Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
    - `object` 'forwarding.request', required — String representing the object's type. Objects of the same type share the same value.
    - `payment_method` string, required — The PaymentMethod to insert into the forwarded request. Forwarding previously consumed PaymentMethods is allowed.
    - `replacements` string[], required — The field kinds to be replaced in the forwarded request.
    - `request_context` ForwardedRequestContext — Metadata about the forwarded request.
      - `destination_duration` integer, required — The time it took in milliseconds for the destination endpoint to respond.
      - `destination_ip_address` string, required — The IP address of the destination.
    - `request_details` ForwardedRequestDetails — Details about the request forwarded to the destination endpoint.
      - `body` string, required — The body payload to send to the destination endpoint.
      - `headers` ForwardedRequestHeader[], required — The headers to include in the forwarded request. Can be omitted if no additional headers (excluding Stripe-generated ones such as the Content-Type header) should be included.
        - `name` string, required — The header name.
        - `value` string, required — The header value.
      - `http_method` 'POST', required — The HTTP method used to call the destination endpoint.
    - `response_details` ForwardedResponseDetails — Details about the response from the destination endpoint.
      - `body` string, required — The response body from the destination endpoint to Stripe.
      - `headers` ForwardedRequestHeader[], required — HTTP headers that the destination endpoint returned.
        - `name` string, required — The header name.
        - `value` string, required — The header value.
      - `status` integer, required — The HTTP status code that the destination endpoint returned.
    - `url` string, nullable — The destination URL for the forwarded request. Must be supported by the config.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/stripe-api.md) · [All operations](https://skmtc.net/stripe/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/stripe-api/revisions/707de00b0616/schema)