POST
/
forward

Authorizations

Authorization
string
headerrequired

Please use your Access Token

Headers

Finch-API-Version
string
default: 2020-09-17required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Body

application/json

Forward Request Body

method
string
required

The HTTP method for the forwarded request. Valid values include: GET , POST , PUT , DELETE , and PATCH.

route
string
required

The URL route path for the forwarded request. This value must begin with a forward-slash ( / ) and may only contain alphanumeric characters, hyphens, and underscores.

headers
object | null

The HTTP headers to include on the forwarded request. This value must be specified as an object of key-value pairs. Example: {"Content-Type": "application/xml", "X-API-Version": "v1" }

params
object | null

The query parameters for the forwarded request. This value must be specified as a valid JSON object rather than a query string.

data
string | null

The body for the forwarded request. This value must be specified as either a string or a valid JSON object.

Response

200 - application/json
headers
object | null
required

The HTTP headers of the forwarded request’s response, exactly as received from the underlying integration’s API.

statusCode
integer
required

The HTTP status code of the forwarded request’s response, exactly received from the underlying integration’s API. This value will be returned as an integer.

data
string | null
required

A string representation of the HTTP response body of the forwarded request’s response received from the underlying integration’s API. This field may be null in the case where the upstream system’s response is empty.

request
object
required

An object containing details of your original forwarded request, for your ease of reference.