{ "openapi": "3.0.3", "info": { "title": "4DevTool API", "description": "Free REST API documentation for 4DevTool developer utilities and country-specific test data: generators, validators, text transforms, hashes, dates, math helpers and API workflow tools. No API key required. CORS enabled. All API labels and responses are in English.", "version": "2.0.0", "contact": { "email": "contact@4devtool.com", "url": "https://www.4devtool.com" } }, "servers": [ { "url": "https://www.4devtool.com/api", "description": "Production" } ], "tags": [ { "name": "Argentina" }, { "name": "Brazil" }, { "name": "France" }, { "name": "Germany" }, { "name": "India" }, { "name": "Italy" }, { "name": "Mexico" }, { "name": "Portugal" }, { "name": "Spain" }, { "name": "Synthetic profiles" }, { "name": "UK" }, { "name": "USA" }, { "name": "Universal" } ], "paths": { "/generate/uuid": { "get": { "tags": [ "Universal" ], "summary": "Generate UUID v4", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UuidGenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/password": { "get": { "tags": [ "Universal" ], "summary": "Generate secure passwords", "parameters": [ { "name": "length", "in": "query", "schema": { "type": "integer", "default": 16 } }, { "name": "uppercase", "in": "query", "schema": { "type": "boolean", "default": true } }, { "name": "numbers", "in": "query", "schema": { "type": "boolean", "default": true } }, { "name": "symbols", "in": "query", "schema": { "type": "boolean", "default": false } }, { "name": "count", "in": "query", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/encode/base64": { "get": { "tags": [ "Universal" ], "summary": "Encode a string to Base64", "parameters": [ { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Base64Response" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/decode/base64": { "get": { "tags": [ "Universal" ], "summary": "Decode Base64 to a string", "parameters": [ { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Base64Response" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/iban": { "get": { "tags": [ "Universal" ], "summary": "Generate IBAN by country", "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string", "default": "us" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/iban": { "get": { "tags": [ "Universal" ], "summary": "Validate IBAN with MOD-97", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cpf": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian CPF", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CpfGenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cpf": { "get": { "tags": [ "Brazil" ], "summary": "Validate Brazilian CPF", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CpfValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cnpj": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian CNPJ", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cnpj-alpha": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian alphanumeric CNPJ (new format)", "description": "Generates a CNPJ with alphanumeric characters (A–Z, 0–9) in the 8-character base, as required by the new Brazilian legislation effective 2026. Check digits are computed with the same modulo-11 algorithm.", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cnpj": { "get": { "tags": [ "Brazil" ], "summary": "Validate Brazilian CNPJ", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/codicefiscale": { "get": { "tags": [ "Italy" ], "summary": "Generate Italian Codice Fiscale", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/codicefiscale": { "get": { "tags": [ "Italy" ], "summary": "Validate Italian Codice Fiscale", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/piva": { "get": { "tags": [ "Italy" ], "summary": "Generate Italian Partita IVA", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/piva": { "get": { "tags": [ "Italy" ], "summary": "Validate Italian Partita IVA", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nif": { "get": { "tags": [ "Spain" ], "summary": "Generate Spanish NIF", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/nif": { "get": { "tags": [ "Spain" ], "summary": "Validate Spanish NIF", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nie": { "get": { "tags": [ "Spain" ], "summary": "Generate Spanish NIE", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/nie": { "get": { "tags": [ "Spain" ], "summary": "Validate Spanish NIE", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/steuerid": { "get": { "tags": [ "Germany" ], "summary": "Generate German Steuer-ID", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/steuerid": { "get": { "tags": [ "Germany" ], "summary": "Validate German Steuer-ID", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/siren": { "get": { "tags": [ "France" ], "summary": "Generate French SIREN", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/siren": { "get": { "tags": [ "France" ], "summary": "Validate French SIREN", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/siret": { "get": { "tags": [ "France" ], "summary": "Generate French SIRET", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/siret": { "get": { "tags": [ "France" ], "summary": "Validate French SIRET", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/ssn": { "get": { "tags": [ "USA" ], "summary": "Generate US SSN", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/ssn": { "get": { "tags": [ "USA" ], "summary": "Validate US SSN", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/ein": { "get": { "tags": [ "USA" ], "summary": "Generate US EIN", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/ein": { "get": { "tags": [ "USA" ], "summary": "Validate US EIN", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nino": { "get": { "tags": [ "UK" ], "summary": "Generate UK National Insurance Number", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/nino": { "get": { "tags": [ "UK" ], "summary": "Validate UK National Insurance Number", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nifpt": { "get": { "tags": [ "Portugal" ], "summary": "Generate Portuguese NIF", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/nifpt": { "get": { "tags": [ "Portugal" ], "summary": "Validate Portuguese NIF", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cuil": { "get": { "tags": [ "Argentina" ], "summary": "Generate Argentine CUIL", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cuil": { "get": { "tags": [ "Argentina" ], "summary": "Validate Argentine CUIL", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cuit": { "get": { "tags": [ "Argentina" ], "summary": "Generate Argentine CUIT", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cuit": { "get": { "tags": [ "Argentina" ], "summary": "Validate Argentine CUIT", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/curp": { "get": { "tags": [ "Mexico" ], "summary": "Generate Mexican CURP", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/curp": { "get": { "tags": [ "Mexico" ], "summary": "Validate Mexican CURP", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/rfc": { "get": { "tags": [ "Mexico" ], "summary": "Generate Mexican RFC", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/rfc": { "get": { "tags": [ "Mexico" ], "summary": "Validate Mexican RFC", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/pan": { "get": { "tags": [ "India" ], "summary": "Generate Indian PAN", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/pan": { "get": { "tags": [ "India" ], "summary": "Validate Indian PAN", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/aadhaar": { "get": { "tags": [ "India" ], "summary": "Generate Indian Aadhaar", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/aadhaar": { "get": { "tags": [ "India" ], "summary": "Validate Indian Aadhaar", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/ulid": { "get": { "tags": [ "Universal" ], "summary": "Generate ULID identifiers", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/random-number": { "get": { "tags": [ "Universal" ], "summary": "Generate random numbers in a range", "parameters": [ { "name": "min", "in": "query", "schema": { "type": "integer", "default": 1 } }, { "name": "max", "in": "query", "schema": { "type": "integer", "default": 100 } }, { "name": "count", "in": "query", "schema": { "type": "integer", "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/random-string": { "get": { "tags": [ "Universal" ], "summary": "Generate random strings", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/lorem": { "get": { "tags": [ "Universal" ], "summary": "Generate placeholder text", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nickname": { "get": { "tags": [ "Universal" ], "summary": "Generate usernames or nicknames", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/credit-card": { "get": { "tags": [ "Universal" ], "summary": "Generate test credit card details", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/credit-card": { "get": { "tags": [ "Universal" ], "summary": "Validate credit card number with Luhn", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/hash": { "get": { "tags": [ "Universal" ], "summary": "Hash a value with SHA algorithms", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "algorithm", "in": "query", "schema": { "type": "string", "enum": [ "md5", "sha1", "sha256", "sha512" ], "default": "sha256" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HashGenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/encode/url": { "get": { "tags": [ "Universal" ], "summary": "URL-encode a string", "parameters": [ { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/decode/url": { "get": { "tags": [ "Universal" ], "summary": "URL-decode a string", "parameters": [ { "name": "value", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/slug": { "get": { "tags": [ "Universal" ], "summary": "Convert text to a URL slug", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/case": { "get": { "tags": [ "Universal" ], "summary": "Convert text case", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/reverse": { "get": { "tags": [ "Universal" ], "summary": "Reverse text", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/sort-lines": { "get": { "tags": [ "Universal" ], "summary": "Sort lines alphabetically", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/remove-accents": { "get": { "tags": [ "Universal" ], "summary": "Remove accents from text", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/html-entities": { "get": { "tags": [ "Universal" ], "summary": "Escape or unescape HTML entities", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/transform/truncate": { "get": { "tags": [ "Universal" ], "summary": "Truncate text", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/calculate/percentage": { "get": { "tags": [ "Universal" ], "summary": "Calculate percentage values", "parameters": [ { "name": "base", "in": "query", "description": "Base value used for the percentage calculation", "required": false, "schema": { "type": "number", "example": 200 } }, { "name": "percentage", "in": "query", "description": "Percentage to calculate from the base value", "required": false, "schema": { "type": "number", "example": 15 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PercentageCalculateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/calculate/gcd-lcm": { "get": { "tags": [ "Universal" ], "summary": "Calculate GCD and LCM", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/date/difference": { "get": { "tags": [ "Universal" ], "summary": "Calculate difference between dates", "parameters": [ { "name": "startDate", "in": "query", "description": "Start date in YYYY-MM-DD format", "required": false, "schema": { "type": "string", "format": "date", "example": "2026-05-01" } }, { "name": "endDate", "in": "query", "description": "End date in YYYY-MM-DD format", "required": false, "schema": { "type": "string", "format": "date", "example": "2026-05-18" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DateDifferenceResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/date/add": { "get": { "tags": [ "Universal" ], "summary": "Add days to a date", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransformResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/name": { "get": { "tags": [ "Synthetic profiles" ], "summary": "Generate a localized name by country", "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string", "default": "us" } }, { "name": "gender", "in": "query", "schema": { "type": "string", "enum": [ "random", "male", "female" ], "default": "random" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/person": { "get": { "tags": [ "Synthetic profiles" ], "summary": "Generate a synthetic person by country", "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string", "default": "us" } }, { "name": "gender", "in": "query", "schema": { "type": "string", "enum": [ "random", "male", "female" ], "default": "random" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonGenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/company": { "get": { "tags": [ "Synthetic profiles" ], "summary": "Generate a synthetic company by country", "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string", "default": "us" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/address": { "get": { "tags": [ "Synthetic profiles" ], "summary": "Generate a synthetic address by country", "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string", "default": "us" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/rg": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian RG", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/rg": { "get": { "tags": [ "Brazil" ], "summary": "Validate Brazilian RG format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cep": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian CEP", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cep": { "get": { "tags": [ "Brazil" ], "summary": "Validate Brazilian CEP format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cnh": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian CNH-like value", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cnh": { "get": { "tags": [ "Brazil" ], "summary": "Validate Brazilian CNH format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/pis": { "get": { "tags": [ "Brazil" ], "summary": "Generate Brazilian PIS/PASEP-like value", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/itin": { "get": { "tags": [ "USA" ], "summary": "Generate US ITIN", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/itin": { "get": { "tags": [ "USA" ], "summary": "Validate US ITIN format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/utr": { "get": { "tags": [ "UK" ], "summary": "Generate UK UTR", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/utr": { "get": { "tags": [ "UK" ], "summary": "Validate UK UTR format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/sort-code": { "get": { "tags": [ "UK" ], "summary": "Generate UK sort code", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/sort-code": { "get": { "tags": [ "UK" ], "summary": "Validate UK sort code format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/postcode": { "get": { "tags": [ "UK" ], "summary": "Generate UK postcode", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cif": { "get": { "tags": [ "Spain" ], "summary": "Generate Spanish CIF", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cif": { "get": { "tags": [ "Spain" ], "summary": "Validate Spanish CIF format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/clabe": { "get": { "tags": [ "Mexico" ], "summary": "Generate Mexican CLABE", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/clabe": { "get": { "tags": [ "Mexico" ], "summary": "Validate Mexican CLABE checksum", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/mx-postal-code": { "get": { "tags": [ "Mexico" ], "summary": "Generate Mexican postal code", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/mx-postal-code": { "get": { "tags": [ "Mexico" ], "summary": "Validate Mexican postal code format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/dni-ar": { "get": { "tags": [ "Argentina" ], "summary": "Generate Argentine DNI", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/dni-ar": { "get": { "tags": [ "Argentina" ], "summary": "Validate Argentine DNI format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/cbu": { "get": { "tags": [ "Argentina" ], "summary": "Generate Argentine CBU", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/cbu": { "get": { "tags": [ "Argentina" ], "summary": "Validate Argentine CBU checksum", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/ccpt": { "get": { "tags": [ "Portugal" ], "summary": "Generate Portuguese citizen card-like value", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/ccpt": { "get": { "tags": [ "Portugal" ], "summary": "Validate Portuguese citizen card format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/niss": { "get": { "tags": [ "Portugal" ], "summary": "Generate Portuguese NISS-like value", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/niss": { "get": { "tags": [ "Portugal" ], "summary": "Validate Portuguese NISS format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/plz": { "get": { "tags": [ "Germany" ], "summary": "Generate German postal code", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/nir": { "get": { "tags": [ "France" ], "summary": "Generate French NIR", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/nir": { "get": { "tags": [ "France" ], "summary": "Validate French NIR key", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/ifsc": { "get": { "tags": [ "India" ], "summary": "Generate Indian IFSC", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/ifsc": { "get": { "tags": [ "India" ], "summary": "Validate Indian IFSC format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/upi": { "get": { "tags": [ "India" ], "summary": "Generate Indian UPI ID", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/upi": { "get": { "tags": [ "India" ], "summary": "Validate Indian UPI ID format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/gstin": { "get": { "tags": [ "India" ], "summary": "Generate Indian GSTIN-like value", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/gstin": { "get": { "tags": [ "India" ], "summary": "Validate Indian GSTIN format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/generate/pin-code": { "get": { "tags": [ "India" ], "summary": "Generate Indian PIN code", "parameters": [ { "name": "count", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "default": 1 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/validate/pin-code": { "get": { "tags": [ "India" ], "summary": "Validate Indian PIN code format", "parameters": [ { "name": "value", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateResponse" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "schemas": { "ErrorResponse": { "type": "object", "required": [ "success", "error" ], "properties": { "success": { "type": "boolean", "example": false }, "error": { "type": "string", "example": "Invalid value" } } }, "GenerateResponse": { "type": "object", "required": [ "success", "data" ], "properties": { "success": { "type": "boolean", "example": true }, "count": { "type": "integer", "example": 1 }, "data": { "type": "array", "items": { "type": "string" } } } }, "ValidateResponse": { "type": "object", "required": [ "success", "valid" ], "properties": { "success": { "type": "boolean", "example": true }, "valid": { "type": "boolean", "example": true }, "input": { "type": "string" }, "details": { "type": "object", "additionalProperties": true } } }, "TransformResponse": { "type": "object", "required": [ "success", "result" ], "properties": { "success": { "type": "boolean", "example": true }, "result": { "type": "string" }, "details": { "type": "object", "additionalProperties": true } } }, "PercentageCalculateResponse": { "type": "object", "required": [ "success", "data" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "object", "required": [ "base", "percentage", "result" ], "properties": { "base": { "type": "number", "example": 200 }, "percentage": { "type": "number", "example": 15 }, "result": { "type": "number", "example": 30 } } } } }, "DateDifferenceResponse": { "type": "object", "required": [ "success", "data" ], "properties": { "success": { "type": "boolean", "example": true }, "data": { "type": "object", "required": [ "startDate", "endDate", "days", "weeks" ], "properties": { "startDate": { "type": "string", "format": "date", "example": "2026-05-01" }, "endDate": { "type": "string", "format": "date", "example": "2026-05-18" }, "days": { "type": "integer", "example": 17 }, "weeks": { "type": "integer", "example": 2 } } } } }, "CpfGenerateResponse": { "allOf": [ { "$ref": "#/components/schemas/GenerateResponse" } ] }, "CpfValidateResponse": { "allOf": [ { "$ref": "#/components/schemas/ValidateResponse" } ] }, "UuidGenerateResponse": { "allOf": [ { "$ref": "#/components/schemas/GenerateResponse" } ] }, "PersonGenerateResponse": { "allOf": [ { "$ref": "#/components/schemas/GenerateResponse" } ] }, "Base64Response": { "allOf": [ { "$ref": "#/components/schemas/TransformResponse" } ] }, "HashGenerateResponse": { "allOf": [ { "$ref": "#/components/schemas/GenerateResponse" } ] } } } }