> ## Documentation Index > Fetch the complete documentation index at: https://docs.iotools.cloud/llms.txt > Use this file to discover all available pages before exploring further. # HTTP Request Parser > Paste a raw HTTP request and get the method, target, version, headers and body split out — with the query string decoded into parameters, the body pretty-printed by Content-Type, and a ready-to-run cURL command to replay it. Runs entirely in your browser. [Try HTTP Request Parser in your browser →](https://iotools.cloud/tool/raw-http-request-parser/) ## OpenAPI ````yaml https://api.iotools.cloud/v1/openapi post /v1/tool/raw-http-request-parser openapi: 3.1.0 info: title: iotools.cloud API version: 1.0.0 description: >- Run any iotools.cloud tool over HTTP. Authenticate with `Authorization: Bearer iot_live_…`. **Only `POST /v1/tool/{slug}` costs credits.** Every GET here — the catalog, a tool's schema, your balance — is free. A tool call is charged its own weight or your plan's per-call minimum, whichever is larger; `x-iotools-credit-cost` on each operation is quoted at the free-tier minimum, and `GET /v1/tools/list` returns the exact figure for your key. `GET /v1/me/credits` reports what you have left, and `GET /v1/me/usage` reports what it went on. Failures are RFC 9457 problem documents — branch on `code`. servers: - url: https://api.iotools.cloud description: Production security: - bearerAuth: [] tags: - name: Catalog description: Find a tool and read its contract. Free. - name: Converters description: >- Convert between formats, encodings, and units — Base64, CSV and JSON, timestamps, and more. Fast, free, and processed right in your browser. - name: Formatters description: >- Format, beautify, minify, and validate code and data — JSON, HTML, CSS, SQL, and regex. Clean up messy input in one click, with nothing to upload. - name: Generators description: >- Generate exactly what you need and on demand — passwords, UUIDs, QR codes, hashes, random numbers, and more. Secure, instant, and free. - name: Calculators description: >- Crunch the numbers fast — from everyday math to specialized conversions and unit work. Free online calculators that run entirely in your browser. - name: Editors description: >- Edit and transform text, code, and images with quick, focused editors that run entirely in your browser — nothing to install, and no sign-up needed. - name: Utilities description: >- Everyday developer and web utilities — DNS and IP lookups, redirect and certificate checkers, and other quick diagnostics. Free and privacy-friendly. - name: Account description: Your key's allowance, limits and usage history. paths: /v1/tool/raw-http-request-parser: post: tags: - Utilities summary: HTTP Request Parser description: >- Paste a raw HTTP request and get the method, target, version, headers and body split out — with the query string decoded into parameters, the body pretty-printed by Content-Type, and a ready-to-run cURL command to replay it. Runs entirely in your browser. [Try HTTP Request Parser in your browser →](https://iotools.cloud/tool/raw-http-request-parser/) operationId: run_raw_http_request_parser requestBody: required: false content: application/json: schema: type: object properties: rawRequest: type: string description: Raw HTTP request bodyHandling: enum: - decode - raw description: Body scheme: enum: - https - http description: Scheme for the cURL URL required: [] examples: json_api_request: summary: JSON API request value: rawRequest: >- POST /api/v1/users?verbose=true&fields=id,name HTTP/1.1 Host: api.example.com User-Agent: curl/8.6.0 Accept: application/json Content-Type: application/json Content-Length: 64 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.abc.def {"name":"Ada Lovelace","email":"ada@example.com","role":"admin"} form_login_repeated_cookie_header: summary: Form login (repeated Cookie header) value: rawRequest: |- POST /login HTTP/1.1 Host: www.example.com Content-Type: application/x-www-form-urlencoded Content-Length: 41 Cookie: session=abc123 Cookie: theme=dark username=ada&password=hunter+2&remember=1 get_with_repeated_query_keys: summary: GET with repeated query keys value: rawRequest: |- GET /search?q=raw%20http&page=2&tag=a&tag=b HTTP/2 Host: example.org Accept-Language: en-GB,en;q=0.9 Referer: https://example.org/ responses: '200': description: Tool output content: application/json: examples: json_api_request: summary: JSON API request value: tool: raw-http-request-parser tool_version: 1.0.1 outputs: summary: - field: Method value: POST - field: Path value: /api/v1/users - field: Query string value: verbose=true&fields=id,name - field: HTTP version value: HTTP/1.1 - field: Host value: api.example.com - field: Content-Type value: application/json - field: Headers value: '6' - field: Query parameters value: '2' - field: Body size value: 64 bytes headers: - header: Host value: api.example.com - header: User-Agent value: curl/8.6.0 - header: Accept value: application/json - header: Content-Type value: application/json - header: Content-Length value: '64' - header: Authorization value: Bearer eyJhbGciOiJIUzI1NiJ9.abc.def query: - parameter: verbose value: 'true' - parameter: fields value: id,name body: |- { "name": "Ada Lovelace", "email": "ada@example.com", "role": "admin" } curl: >- curl -X POST 'https://api.example.com/api/v1/users?verbose=true&fields=id,name' \ -H 'User-Agent: curl/8.6.0' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.abc.def' \ --data-raw '{"name":"Ada Lovelace","email":"ada@example.com","role":"admin"}' json: |- { "method": "POST", "target": "/api/v1/users?verbose=true&fields=id,name", "httpVersion": "HTTP/1.1", "path": "/api/v1/users", "queryParameters": [ { "name": "verbose", "value": "true" }, { "name": "fields", "value": "id,name" } ], "headers": [ { "name": "Host", "values": [ "api.example.com" ] }, { "name": "User-Agent", "values": [ "curl/8.6.0" ] }, { "name": "Accept", "values": [ "application/json" ] }, { "name": "Content-Type", "values": [ "application/json" ] }, { "name": "Content-Length", "values": [ "64" ] }, { "name": "Authorization", "values": [ "Bearer eyJhbGciOiJIUzI1NiJ9.abc.def" ] } ], "body": { "raw": "{\"name\":\"Ada Lovelace\",\"email\":\"ada@example.com\",\"role\":\"admin\"}", "bytes": 64, "contentType": "application/json", "parsed": { "name": "Ada Lovelace", "email": "ada@example.com", "role": "admin" } } } credits_used: 3 credits_remaining: null form_login_repeated_cookie_header: summary: Form login (repeated Cookie header) value: tool: raw-http-request-parser tool_version: 1.0.1 outputs: summary: - field: Method value: POST - field: Path value: /login - field: Query string value: (none) - field: HTTP version value: HTTP/1.1 - field: Host value: www.example.com - field: Content-Type value: application/x-www-form-urlencoded - field: Headers value: '4' - field: Query parameters value: '0' - field: Body size value: 41 bytes headers: - header: Host value: www.example.com - header: Content-Type value: application/x-www-form-urlencoded - header: Content-Length value: '41' - header: Cookie value: session=abc123 - header: Cookie value: theme=dark query: [] body: |- username = ada password = hunter 2 remember = 1 curl: |- curl -X POST 'https://www.example.com/login' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -H 'Cookie: session=abc123' \ -H 'Cookie: theme=dark' \ --data-raw 'username=ada&password=hunter+2&remember=1' json: |- { "method": "POST", "target": "/login", "httpVersion": "HTTP/1.1", "path": "/login", "queryParameters": [], "headers": [ { "name": "Host", "values": [ "www.example.com" ] }, { "name": "Content-Type", "values": [ "application/x-www-form-urlencoded" ] }, { "name": "Content-Length", "values": [ "41" ] }, { "name": "Cookie", "values": [ "session=abc123", "theme=dark" ] } ], "body": { "raw": "username=ada&password=hunter+2&remember=1", "bytes": 41, "contentType": "application/x-www-form-urlencoded", "parsed": [ { "name": "username", "value": "ada" }, { "name": "password", "value": "hunter 2" }, { "name": "remember", "value": "1" } ] } } credits_used: 3 credits_remaining: null get_with_repeated_query_keys: summary: GET with repeated query keys value: tool: raw-http-request-parser tool_version: 1.0.1 outputs: summary: - field: Method value: GET - field: Path value: /search - field: Query string value: q=raw%20http&page=2&tag=a&tag=b - field: HTTP version value: HTTP/2 - field: Host value: example.org - field: Content-Type value: (not set) - field: Headers value: '3' - field: Query parameters value: '4' - field: Body size value: 0 bytes headers: - header: Host value: example.org - header: Accept-Language value: en-GB,en;q=0.9 - header: Referer value: https://example.org/ query: - parameter: q value: raw http - parameter: page value: '2' - parameter: tag value: a - parameter: tag value: b body: '' curl: >- curl -X GET 'https://example.org/search?q=raw%20http&page=2&tag=a&tag=b' \ -H 'Accept-Language: en-GB,en;q=0.9' \ -H 'Referer: https://example.org/' json: |- { "method": "GET", "target": "/search?q=raw%20http&page=2&tag=a&tag=b", "httpVersion": "HTTP/2", "path": "/search", "queryParameters": [ { "name": "q", "value": "raw http" }, { "name": "page", "value": "2" }, { "name": "tag", "value": "a" }, { "name": "tag", "value": "b" } ], "headers": [ { "name": "Host", "values": [ "example.org" ] }, { "name": "Accept-Language", "values": [ "en-GB,en;q=0.9" ] }, { "name": "Referer", "values": [ "https://example.org/" ] } ], "body": { "raw": "", "bytes": 0, "contentType": null, "parsed": null } } credits_used: 3 credits_remaining: null schema: type: object required: - tool - tool_version - outputs - credits_used - credits_remaining properties: outputs: type: object properties: summary: type: array description: Request items: type: object properties: field: type: string description: Field value: type: string description: Value x-iotools-columns: - field - value headers: type: array description: Headers items: type: object properties: header: type: string description: Header value: type: string description: Value x-iotools-columns: - header - value query: type: array description: Query parameters items: type: object properties: parameter: type: string description: Parameter value: type: string description: Value x-iotools-columns: - parameter - value body: type: string description: Body curl: type: string description: Equivalent cURL command json: type: string description: JSON tool: type: string description: The tool's slug, echoing the {slug} in the request path. tool_version: type: string description: Output-contract version for this tool. credits_used: type: integer description: >- Credits this call consumed, after any settlement refund. 0 when metering is disabled. credits_remaining: type: - integer - 'null' description: >- Credits left in the current monthly allowance, or null when metering is disabled. request_id: type: string description: Correlation id, also sent as x-request-id. '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/InsufficientCredits' '403': $ref: '#/components/responses/ToolNotAllowed' '404': $ref: '#/components/responses/ToolNotFound' '413': $ref: '#/components/responses/PayloadTooLarge' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/ToolFailed' '503': $ref: '#/components/responses/ToolDisabled' security: - bearerAuth: [] components: responses: ValidationError: description: Invalid request. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/validation_error title: type: string description: Short human-readable summary of the failure. examples: - Invalid request status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - validation_error detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. fields: type: - object - string additionalProperties: type: string description: >- What failed: a map of field name → message. Absent when the body itself is malformed; a single string when the failure isn't tied to one field. example: type: https://iotools.cloud/docs/errors/validation_error title: Invalid request status: 400 code: validation_error detail: One or more inputs are invalid — see `fields`. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 fields: inputString: Required Unauthorized: description: Missing or invalid API key. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/invalid_api_key title: type: string description: Short human-readable summary of the failure. examples: - Invalid API key status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - invalid_api_key detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. example: type: https://iotools.cloud/docs/errors/invalid_api_key title: Invalid API key status: 401 code: invalid_api_key detail: 'Provide ''Authorization: Bearer ''.' request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 InsufficientCredits: description: Monthly credit allowance exhausted. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/insufficient_credits title: type: string description: Short human-readable summary of the failure. examples: - Insufficient credits status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - insufficient_credits detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. credits_used: type: integer description: Always 0 — a refused call charges nothing. credits_remaining: type: integer description: Credits left in the allowance — fewer than this call costs. example: type: https://iotools.cloud/docs/errors/insufficient_credits title: Insufficient credits status: 402 code: insufficient_credits detail: This call costs 1 credit and 0 remain in this month's allowance. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 credits_used: 0 credits_remaining: 0 ToolNotAllowed: description: Tool exists but has no API surface. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/tool_not_allowed title: type: string description: Short human-readable summary of the failure. examples: - Tool not available over the API status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - tool_not_allowed detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. example: type: https://iotools.cloud/docs/errors/tool_not_allowed title: Tool not available over the API status: 403 code: tool_not_allowed detail: >- "Background Remover" is available on iotools.cloud but has no API endpoint. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 ToolNotFound: description: No such tool. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/tool_not_found title: type: string description: Short human-readable summary of the failure. examples: - Tool not found status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - tool_not_found detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. example: type: https://iotools.cloud/docs/errors/tool_not_found title: Tool not found status: 404 code: tool_not_found detail: No tool with that slug. See GET /v1/tools/list. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 PayloadTooLarge: description: Body too large. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/payload_too_large title: type: string description: Short human-readable summary of the failure. examples: - Payload too large status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - payload_too_large detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. example: type: https://iotools.cloud/docs/errors/payload_too_large title: Payload too large status: 413 code: payload_too_large detail: Request body exceeds this tool's size limit. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 RateLimited: description: Per-minute rate limit exceeded. headers: Retry-After: description: Seconds to wait before retrying (RFC 9110 delta-seconds). schema: type: integer content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/rate_limited title: type: string description: Short human-readable summary of the failure. examples: - Rate limit exceeded status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - rate_limited detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. retry_after: type: integer description: >- Seconds until the window resets — the same value as the `Retry-After` header. example: type: https://iotools.cloud/docs/errors/rate_limited title: Rate limit exceeded status: 429 code: rate_limited detail: Too many requests. Retry in 30s. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 retry_after: 30 ToolFailed: description: Tool failed to run. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/processing_error - https://iotools.cloud/docs/errors/internal_error title: type: string description: Short human-readable summary of the failure. examples: - Tool failed to run - Internal error status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - processing_error - internal_error detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. credits_used: type: integer description: >- Always 0 on `processing_error` — a failed run is refunded, floor included. credits_remaining: type: integer description: >- Credits left after the refund. Absent when metering is disabled. example: type: https://iotools.cloud/docs/errors/processing_error title: Tool failed to run status: 500 code: processing_error detail: The tool failed to run. Please try again. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 credits_used: 0 ToolDisabled: description: Tool temporarily disabled. content: application/problem+json: schema: type: object description: >- RFC 9457 problem document, served as application/problem+json. Branch on `code`; `title` is human prose and may be reworded without notice. Some failures add extension members — `fields` on validation errors, `retry_after` on 429s, `credits_used`/`credits_remaining` on billing-adjacent failures — documented on the responses that carry them. required: - type - title - status - code properties: type: type: string format: uri description: Stable documentation URI for this failure. examples: - https://iotools.cloud/docs/errors/tool_disabled - https://iotools.cloud/docs/errors/api_unconfigured title: type: string description: Short human-readable summary of the failure. examples: - Tool temporarily disabled - API not configured status: type: integer description: HTTP status code, matching the response's own status. code: type: string description: >- Stable machine-readable error code — branch on this, not `title`. enum: - tool_disabled - api_unconfigured detail: type: string description: Human explanation of this occurrence. request_id: type: string description: Correlation id, also sent as x-request-id. example: type: https://iotools.cloud/docs/errors/tool_disabled title: Tool temporarily disabled status: 503 code: tool_disabled detail: This tool is temporarily unavailable. Try again shortly. request_id: e4042b29-8f1e-4c7a-9b52-6f0d1a3c7e11 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: iot_live_… ````