{
  "info": {
    "name": "GenderAPI Public API — Local Draft",
    "description": "Generated from the API-owner-approved OpenAPI 3.1 contract. Obtain explicit release approval before using a production credential or sending personal data.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.genderapi.io",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Infer gender from one name",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Alice\",\n  \"country\": \"US\",\n  \"askToAI\": true\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-name-single\n\nCredit guidance: One lookup; AI fallback may have different usage accounting. Confirm current terms."
      },
      "response": []
    },
    {
      "name": "Infer gender from multiple names",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/name/multi/country",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "name",
            "multi",
            "country"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": [\n    {\n      \"name\": \"Andrea\",\n      \"country\": \"DE\",\n      \"id\": \"123\"\n    }\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-name-multiple\n\nCredit guidance: Credits are consumed per processed record, not per HTTP request."
      },
      "response": []
    },
    {
      "name": "Extract a name and infer gender from one email address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "email"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"alice.smith@example.com\",\n  \"country\": \"US\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-email-single\n\nCredit guidance: One lookup; AI fallback may have different usage accounting. Confirm current terms."
      },
      "response": []
    },
    {
      "name": "Extract names and infer gender from multiple email addresses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/email/multi/country",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "email",
            "multi",
            "country"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": [\n    {\n      \"email\": \"anna.smith@example.com\",\n      \"country\": \"US\",\n      \"id\": \"123\"\n    }\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-email-multiple\n\nCredit guidance: Credits are consumed per processed record, not per HTTP request."
      },
      "response": []
    },
    {
      "name": "Extract a name and infer gender from one username",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/username",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "username"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"username\": \"anna_smith88\",\n  \"country\": \"US\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-username-single\n\nCredit guidance: One lookup; AI options may have different usage accounting. Confirm current terms."
      },
      "response": []
    },
    {
      "name": "Extract names and infer gender from multiple usernames",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/username/multi/country",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "username",
            "multi",
            "country"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": [\n    {\n      \"username\": \"anna_smith88\",\n      \"country\": \"US\",\n      \"id\": \"123\"\n    }\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-gender-from-username-multiple\n\nCredit guidance: Credits are consumed per processed record, not per HTTP request."
      },
      "response": []
    },
    {
      "name": "Retrieve remaining quota and expiration",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/remaining",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "remaining"
          ],
          "query": [
            {
              "key": "key",
              "value": "{{apiKey}}",
              "type": "text"
            }
          ]
        },
        "description": "This endpoint requires the key query parameter. Keep the request server-side and redact the full URL and query string from logs; Bearer authentication was rejected with errno 94 during live verification.\n\nCredit guidance: Does not perform a gender lookup."
      },
      "response": []
    },
    {
      "name": "Validate and format a phone number using query parameters",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/phone",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "phone"
          ],
          "query": [
            {
              "key": "key",
              "value": "{{apiKey}}",
              "type": "text"
            },
            {
              "key": "number",
              "value": "<number>",
              "disabled": false
            },
            {
              "key": "address",
              "value": "<address>",
              "disabled": true
            }
          ]
        },
        "description": "POST with Bearer authentication is preferred for secret handling.\n\nCredit guidance: Confirm current usage accounting in account and pricing documentation."
      },
      "response": []
    },
    {
      "name": "Validate and format a phone number",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "auth": {
          "type": "bearer",
          "bearer": [
            {
              "key": "token",
              "value": "{{apiKey}}",
              "type": "string"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/api/phone",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "phone"
          ],
          "query": []
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"number\": \"+1 212 867 5309\",\n  \"address\": \"US\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Canonical documentation: https://www.genderapi.io/docs-phone-validation-formatter-api\n\nCredit guidance: Confirm current usage accounting in account and pricing documentation."
      },
      "response": []
    }
  ]
}