How to pass both headers and query parameters in GET request in API Gateway

Question

I have a GET request which uses some Query Parameters and I'm trying to pass in headers as well in API Gateway, but seems like I'm not able to access Headers.

If I pass in a header like this:
```
"get" : {
        "parameters" : [ {
          "name" : "custom-header",
          "in" : "header",
          "schema" : {
            "type" : "string"
          }
        }],
       "x-amazon-apigateway-integration" : {
          ...
         "httpMethod" : "GET",
          "requestParameters" : {
            "integration.request.header.custom-header" : "method.request.header.custom-header"
          },
         ...
       }
...
}
```
without passing in any query string parameters, it works and I can see headers passing through in GET request.

However, when I try to do the following:
```
"get" : {
        "parameters" : [ {
          "name" : "custom-header",
          "in" : "header",
          "schema" : {
            "type" : "string"
          }
        },
       {
          "name" : "query_param",
          "in" : "query",
          "schema" : {
            "type" : "string"
          }
        },

],
       "x-amazon-apigateway-integration" : {
          ...
         "httpMethod" : "GET",
          "requestParameters" : {
             "integration.request.querystring.query_param" : "method.request.querystring.query_param",
            "integration.request.header.custom-header" : "method.request.header.custom-header"
          },
         ...
       }
...
}
```
It does not work, i.e. I do not see the headers being passed through in the GET request.

On this documentation page by AWS [here](https://docs.aws.amazon.com/apigateway/latest/developerguide/request-response-data-mappings.html#request-response-data-mappings-example-2), it is stated that to use query parameters and headers in GET request, it is defined as POST request and the `httpMethod` is defined as `GET`.  Does this mean I'm unable to use query parameters and headers together in GET requests? and have to switch to POST?

re:Post Agent · Answer

You can definitely pass both headers and query parameters in a GET request in API Gateway. The issue you're experiencing is likely related to how you're configuring the parameter mappings.

To pass both headers and query parameters in a GET request:

1. In your API Gateway configuration, make sure both the header and query parameters are properly defined in the Method Request section.

2. Then in the Integration Request section, map both the header and query parameters correctly:

For headers:
```
"integration.request.header.custom-header": "method.request.header.custom-header"
```

For query parameters:
```
"integration.request.querystring.query_param": "method.request.querystring.query_param"
```

Your configuration looks correct based on what you've shared. A few things to check:

- Make sure you're actually sending the custom header in your test requests
- Verify that your API has been redeployed after making these changes
- Check if there are any caching issues affecting your tests

API Gateway fully supports passing both headers and query parameters in GET requests - you don't need to switch to POST. The documentation you referenced is likely showing a specific use case for transforming a POST request to a GET request at the integration level, not suggesting that you can't use headers with GET requests.

If you're using the AWS console, you can also try:
1. Go to the Method Request configuration
2. Add both your header and query parameter there
3. Then in Integration Request, map both parameters as shown above
4. Save and deploy your API

API Gateway supports multi-value headers and parameters, so there shouldn't be any technical limitation preventing you from using both in a GET request.  
**Sources**  
[Passing X-Forwarded-Host and X-Forwarded-Port headers from API Gateway | AWS re:Post](https://repost.aws/questions/QUVOlicSi0QGmjn3w9AO9_BQ/passing-x-forwarded-host-and-x-forwarded-port-headers-from-api-gateway)  
[Transform API requests and responses for HTTP APIs in API Gateway - Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/http-api-parameter-mapping.html)  
[Lambda proxy integrations in API Gateway - Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html)  
[Tutorial: Create a REST API with an HTTP non-proxy integration - Amazon API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-create-api-step-by-step.html)

How to pass both headers and query parameters in GET request in API Gateway

Add your answer

Relevant content