> ## Documentation Index
> Fetch the complete documentation index at: https://docs.methodfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The Forwarding Request endpoint

A ForwardingRequest is a one-time execution that securely forwards sensitive data to
external APIs. It allows you to make outbound requests using templated values from
Method resources (such as payment instruments, secrets, and entities) without exposing the
underlying sensitive data.

Template expressions use the `{{binding_name.path.to.field}}` syntax to reference values
from bound resources.

## ForwardingRequest Objects

```json THE FORWARDING REQUEST OBJECT theme={null}
{
  "id": "freq_f6xGfRQyQxDc",
  "bindings": {
    "payment_instrument": "pmt_inst_7TNTTRQwQxWc",
    "secret": "sec_au22b1fbFrmfp",
    "entity": "ent_au22b1FBFJbp8"
  },
  "request": {
    "url": "https://sample-url/v1/tokens",
    "method": "POST",
    "headers": {
      "Content-Type": "application/json",
      "Authorization": "Bearer {{secret.value}}"
    },
    "body": "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"number\":\"{{payment_instrument.card.number}}\",\"month\":\"{{payment_instrument.card.exp_month}}\",\"year\":\"{{payment_instrument.card.exp_year}}\",\"cvv\":\"{{payment_instrument.card.cvv}}\",\"address1\":\"123 Main St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"country\":\"US\",\"postal_code\":\"94110\"}"
  },
  "response": {
    "status_code": 200,
    "headers": {
      "content-type": "application/json; charset=utf-8",
      "x-request-id": "3a92e6c6-7661-4270-bf31-2d4cc25ea911"
    },
    "body": {
      "type": "credit_card",
      "id": "vJlxp8rHhCq9FNCNF6VYeA",
      "card": {
        "brand": "visa",
        "first_six": "411111",
        "last_four": "1111",
        "exp_month": 2,
        "exp_year": 2030,
        "issuing_country": "US",
        "funding_source": "credit"
      }
    }
  },
  "duration_ms": 953,
  "created_at": "2025-12-04T18:50:54.024Z",
  "updated_at": "2025-12-04T18:50:54.024Z",
  "status": "completed"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.