Skip to content
Spaw
Get your API key

METHOD_NOT_ALLOWED

The endpoint does not accept that HTTP method

The path exists but not for this verb — a GET where the endpoint takes POST, most often. The response carries an Allow header naming the methods it does take. Nothing is charged.

http status
405
credits
Nothing is billed for a failed request.

What it means

Every lookup endpoint takes POST, because the value being verified belongs in a body rather than a URL that would be logged by proxies along the way. The read-only endpoints (a bulk job's status, a monitor, the account) take GET.

A client that follows a redirect can turn a POST into a GET and arrive here. Call the documented URL directly, with its scheme and no trailing slash.

What to do

Read the Allow header, or the endpoint's reference page, and resend with the method it names.

Example response 

{
    "success": false,
    "error": {
        "code": "METHOD_NOT_ALLOWED",
        "message": "This endpoint does not accept that HTTP method. The Allow header names the ones it does.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

Related

markdown version: /docs/errors/METHOD_NOT_ALLOWED.md