---
title: "With your API key"
method: POST
path: "/api/v1/free-proxy/check"
tags: ["Proxy checker API"]
---

# With your API key

`POST /api/v1/free-proxy/check`

## Request

- Base URL: `https://hproxy.com`
- URL: `https://hproxy.com/api/v1/free-proxy/check`
- Auth: API key in header `X-API-Key`

Every checker endpoint also answers under `/api/v1` for an API key: `POST /api/v1/free-proxy/check` streams, `GET` and `POST /api/v1/proxy-check` answer in one response. Same bodies, same result rows, and your account's tier: ten times the requests and 3,000,000 proxies a day, counted on the account rather than on the address, so a whole team behind one office connection is not squeezed into one person's budget. Any key works; checking spends nothing and needs no scope. Errors come back in the usual `/api/v1` shape, `{ "error", "code" }`.

## Request body

- object
  - `X-API-Key` string, required: Your hpx_ key (or Authorization: Bearer hpx_...).

## Response `200`

Success

- object

## Other responses

- `400`: Invalid input. The body names the field and the accepted set.
- `401`: Missing or invalid API key.
- `429`: Rate limited. Retry after the delay in the response.

---

[API](https://skmtc.dev/hproxy/apis/hproxy-api.md) · [All operations](https://skmtc.dev/hproxy/apis/hproxy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hproxy/apis/hproxy-api/revisions/9f6898fe76e2?raw)