{
  "info": {
    "name": "GenderAPI v2",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Import this collection and optionally the GenderAPI v2 environment. Set apiKey to your existing key (without the Bearer prefix); leave it empty for the shared IP trial. An unknown key also uses the trial, so check meta.access.mode for api_key when integrating an account. Keep your actual key in your private local environment. baseUrl is the API origin, without /api/v2. Examples and saved responses use synthetic data.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.\n\nDocumentation: https://www.genderapi.io/api-documentation\nOpenAPI source: https://api.genderapi.io/api/v2/openapi.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.genderapi.io",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Service",
      "item": [
        {
          "name": "GET · Service capabilities",
          "request": {
            "method": "GET",
            "auth": {
              "type": "noauth"
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2"
              ]
            },
            "description": "Service capabilities\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": []
        },
        {
          "name": "GET · Error codes and recovery",
          "request": {
            "method": "GET",
            "auth": {
              "type": "noauth"
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/errors",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "errors"
              ]
            },
            "description": "Error codes and recovery\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": []
        },
        {
          "name": "GET · Canonical OpenAPI specification",
          "request": {
            "method": "GET",
            "auth": {
              "type": "noauth"
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/openapi.json",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "openapi.json"
              ]
            },
            "description": "Canonical OpenAPI specification\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Account",
      "item": [
        {
          "name": "GET · Credits and balance — free",
          "request": {
            "method": "GET",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/usage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "usage"
              ]
            },
            "description": "Credits and balance — free\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": [
            {
              "name": "Illustrative usage response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/usage",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "usage"
                  ]
                },
                "description": "Credits and balance — free\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Current shared balance; this request is free.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"remaining_credits\": 9,\n    \"expires_at\": \"2026-09-26T12:00:00.000Z\",\n    \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n    \"limit\": 10,\n    \"period_seconds\": 86400\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        }
      ]
    },
    {
      "name": "Single lookups",
      "item": [
        {
          "name": "POST · Name",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"country\": \"TR\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Email",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"jane.doe@example.com\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Username",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"maria_92\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Nickname as a name",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Nickname in an email",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"email\",\n  \"value\": \"prenses@example.com\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Nickname as a username",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"username\",\n  \"value\": \"prenses\",\n  \"country\": \"TR\",\n  \"forceToGenderize\": true\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Dataset only",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"off\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Explicit AI — 2 credits",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ]
            },
            "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ]
                },
                "description": "Single name, email or username. Ordinary ai_mode defaults to fallback and costs 1 credit even after AI fallback. forceToGenderize true always checks the dataset first: a resolved gender costs 1; otherwise nickname-based AI costs 2 total, including a valid null result. A real given name is not required in this mode; input.forceToGenderize marks the relaxed name requirement in the response. Combining forceToGenderize true with ai_mode off/always is invalid (422). Without force, off disables AI and always skips the dataset for 2 credits. Provider/dataset errors are errors, not misses; failed work is not charged.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"type\": \"name\",\n  \"value\": \"Onur\",\n  \"options\": {\n    \"ai_mode\": \"always\"\n  }\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "GET · Name",
          "request": {
            "method": "GET",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ],
              "query": [
                {
                  "key": "type",
                  "value": "name",
                  "disabled": false
                },
                {
                  "key": "value",
                  "value": "Onur",
                  "disabled": false
                },
                {
                  "key": "country",
                  "value": "TR",
                  "disabled": false
                },
                {
                  "key": "forceToGenderize",
                  "value": "false",
                  "disabled": true
                },
                {
                  "key": "ai_mode",
                  "value": "fallback",
                  "disabled": true
                }
              ]
            },
            "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=name&value=Onur&country=TR",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "name",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "Onur",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "GET · Email",
          "request": {
            "method": "GET",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ],
              "query": [
                {
                  "key": "type",
                  "value": "email",
                  "disabled": false
                },
                {
                  "key": "value",
                  "value": "jane.doe@example.com",
                  "disabled": false
                },
                {
                  "key": "country",
                  "value": "US",
                  "disabled": false
                },
                {
                  "key": "forceToGenderize",
                  "value": "false",
                  "disabled": true
                },
                {
                  "key": "ai_mode",
                  "value": "fallback",
                  "disabled": true
                }
              ]
            },
            "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=email&value=jane.doe%40example.com&country=US",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "email",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "jane.doe@example.com",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "US",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "GET · Username",
          "request": {
            "method": "GET",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ],
              "query": [
                {
                  "key": "type",
                  "value": "username",
                  "disabled": false
                },
                {
                  "key": "value",
                  "value": "maria_92",
                  "disabled": false
                },
                {
                  "key": "country",
                  "value": "TR",
                  "disabled": true
                },
                {
                  "key": "forceToGenderize",
                  "value": "false",
                  "disabled": true
                },
                {
                  "key": "ai_mode",
                  "value": "fallback",
                  "disabled": true
                }
              ]
            },
            "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=maria_92",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "maria_92",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": true
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "false",
                      "disabled": true
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "GET · Nickname as a username",
          "request": {
            "method": "GET",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender"
              ],
              "query": [
                {
                  "key": "type",
                  "value": "username",
                  "disabled": false
                },
                {
                  "key": "value",
                  "value": "prenses",
                  "disabled": false
                },
                {
                  "key": "country",
                  "value": "TR",
                  "disabled": false
                },
                {
                  "key": "forceToGenderize",
                  "value": "true",
                  "disabled": false
                },
                {
                  "key": "ai_mode",
                  "value": "fallback",
                  "disabled": true
                }
              ]
            },
            "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
          },
          "response": [
            {
              "name": "Illustrative dataset response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    \"name\": \"onur\",\n    \"gender\": \"male\",\n    \"country\": \"TR\",\n    \"confidence\": 0.9,\n    \"confidence_kind\": \"observed_frequency\",\n    \"sample_count\": 100,\n    \"source\": \"dataset\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"dataset\",\n    \"match\": {\n      \"name\": \"onur\",\n      \"method\": \"normalized\",\n      \"scope\": \"country\",\n      \"country\": \"TR\"\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 9,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative alias response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"username\",\n      \"value\": \"prenses\",\n      \"country\": \"TR\",\n      \"forceToGenderize\": true\n    },\n    \"name\": null,\n    \"gender\": \"female\",\n    \"country\": \"TR\",\n    \"confidence\": 0.7,\n    \"confidence_kind\": \"model_reported\",\n    \"sample_count\": null,\n    \"source\": \"ai\",\n    \"result_status\": \"identified\",\n    \"reason\": null,\n    \"country_source\": \"ai_association\",\n    \"match\": {\n      \"name\": null,\n      \"method\": \"model_inference\",\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": -1,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unknown response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"input\": {\n      \"type\": \"name\",\n      \"value\": \"zzzxxyy\",\n      \"country\": null\n    },\n    \"name\": null,\n    \"gender\": null,\n    \"country\": null,\n    \"confidence\": null,\n    \"confidence_kind\": null,\n    \"sample_count\": null,\n    \"source\": \"none\",\n    \"result_status\": \"unknown\",\n    \"reason\": \"not_found\",\n    \"country_source\": null,\n    \"match\": {\n      \"name\": null,\n      \"method\": null,\n      \"scope\": null,\n      \"country\": null\n    }\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 8,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative insufficient response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 403,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:insufficient_credits\",\n  \"title\": \"insufficient credits\",\n  \"status\": 403,\n  \"detail\": \"At least one starting credit is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"insufficient_credits\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"add_credits_or_wait_for_reset\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 0,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative validation response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 422,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:validation_error\",\n  \"title\": \"validation error\",\n  \"status\": 422,\n  \"detail\": \"A valid email address is required.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"validation_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"correct_request\",\n  \"errors\": [\n    {\n      \"pointer\": \"/value\",\n      \"message\": \"Invalid email address.\"\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": null,\n      \"billing_status\": \"not_charged\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative unconfirmed response (synthetic data)",
              "originalRequest": {
                "method": "GET",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender?type=username&value=prenses&country=TR&forceToGenderize=true",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender"
                  ],
                  "query": [
                    {
                      "key": "type",
                      "value": "username",
                      "disabled": false
                    },
                    {
                      "key": "value",
                      "value": "prenses",
                      "disabled": false
                    },
                    {
                      "key": "country",
                      "value": "TR",
                      "disabled": false
                    },
                    {
                      "key": "forceToGenderize",
                      "value": "true",
                      "disabled": false
                    },
                    {
                      "key": "ai_mode",
                      "value": "fallback",
                      "disabled": true
                    }
                  ]
                },
                "description": "Browser-friendly single prediction. Same pricing and validation as POST. Every request is processed and billed separately, including repeated requests. Responses are not cacheable. HEAD is rejected. Prefer Bearer authentication for integrations; query keys appear in browser history.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured."
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 503,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:billing_reconciliation_required\",\n  \"title\": \"billing reconciliation required\",\n  \"status\": 503,\n  \"detail\": \"Contact support; do not automatically retry.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"billing_reconciliation_required\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"contact_support\",\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": null,\n      \"remaining_credits\": null,\n      \"billing_status\": \"unconfirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        }
      ]
    },
    {
      "name": "Bulk lookups",
      "item": [
        {
          "name": "POST · Names",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender/batch",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender",
                "batch"
              ]
            },
            "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"id\": \"name-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"name-2\",\n      \"type\": \"name\",\n      \"value\": \"Jane\",\n      \"country\": \"US\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative batch response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"name-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"name-2\",\n      \"type\": \"name\",\n      \"value\": \"Jane\",\n      \"country\": \"US\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": [\n    {\n      \"index\": 0,\n      \"id\": \"known\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"Onur\",\n          \"country\": \"TR\"\n        },\n        \"name\": \"onur\",\n        \"gender\": \"male\",\n        \"country\": \"TR\",\n        \"confidence\": 0.9,\n        \"confidence_kind\": \"observed_frequency\",\n        \"sample_count\": 100,\n        \"source\": \"dataset\",\n        \"result_status\": \"identified\",\n        \"reason\": null,\n        \"country_source\": \"dataset\",\n        \"match\": {\n          \"name\": \"onur\",\n          \"method\": \"normalized\",\n          \"scope\": \"country\",\n          \"country\": \"TR\"\n        }\n      }\n    },\n    {\n      \"index\": 1,\n      \"id\": \"missing\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"zzzxxyy\",\n          \"country\": null\n        },\n        \"name\": null,\n        \"gender\": null,\n        \"country\": null,\n        \"confidence\": null,\n        \"confidence_kind\": null,\n        \"sample_count\": null,\n        \"source\": \"none\",\n        \"result_status\": \"unknown\",\n        \"reason\": \"not_found\",\n        \"country_source\": null,\n        \"match\": {\n          \"name\": null,\n          \"method\": null,\n          \"scope\": null,\n          \"country\": null\n        }\n      }\n    },\n    {\n      \"index\": 2,\n      \"id\": \"failed\",\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"succeeded\": 2,\n      \"identified\": 1,\n      \"unknown\": 1,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative batchFailed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"name-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"name-2\",\n      \"type\": \"name\",\n      \"value\": \"Jane\",\n      \"country\": \"US\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 502,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n  \"title\": \"ai upstream error\",\n  \"status\": 502,\n  \"detail\": \"The AI provider could not complete the request.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"ai_upstream_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"inspect_billing_before_retry\",\n  \"data\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"results\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 1,\n      \"succeeded\": 0,\n      \"identified\": 0,\n      \"unknown\": 0,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Emails",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender/batch",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender",
                "batch"
              ]
            },
            "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"id\": \"email-1\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\"\n    },\n    {\n      \"id\": \"email-2\",\n      \"type\": \"email\",\n      \"value\": \"john.smith@example.com\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative batch response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"email-1\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\"\n    },\n    {\n      \"id\": \"email-2\",\n      \"type\": \"email\",\n      \"value\": \"john.smith@example.com\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": [\n    {\n      \"index\": 0,\n      \"id\": \"known\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"Onur\",\n          \"country\": \"TR\"\n        },\n        \"name\": \"onur\",\n        \"gender\": \"male\",\n        \"country\": \"TR\",\n        \"confidence\": 0.9,\n        \"confidence_kind\": \"observed_frequency\",\n        \"sample_count\": 100,\n        \"source\": \"dataset\",\n        \"result_status\": \"identified\",\n        \"reason\": null,\n        \"country_source\": \"dataset\",\n        \"match\": {\n          \"name\": \"onur\",\n          \"method\": \"normalized\",\n          \"scope\": \"country\",\n          \"country\": \"TR\"\n        }\n      }\n    },\n    {\n      \"index\": 1,\n      \"id\": \"missing\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"zzzxxyy\",\n          \"country\": null\n        },\n        \"name\": null,\n        \"gender\": null,\n        \"country\": null,\n        \"confidence\": null,\n        \"confidence_kind\": null,\n        \"sample_count\": null,\n        \"source\": \"none\",\n        \"result_status\": \"unknown\",\n        \"reason\": \"not_found\",\n        \"country_source\": null,\n        \"match\": {\n          \"name\": null,\n          \"method\": null,\n          \"scope\": null,\n          \"country\": null\n        }\n      }\n    },\n    {\n      \"index\": 2,\n      \"id\": \"failed\",\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"succeeded\": 2,\n      \"identified\": 1,\n      \"unknown\": 1,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative batchFailed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"email-1\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\"\n    },\n    {\n      \"id\": \"email-2\",\n      \"type\": \"email\",\n      \"value\": \"john.smith@example.com\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 502,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n  \"title\": \"ai upstream error\",\n  \"status\": 502,\n  \"detail\": \"The AI provider could not complete the request.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"ai_upstream_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"inspect_billing_before_retry\",\n  \"data\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"results\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 1,\n      \"succeeded\": 0,\n      \"identified\": 0,\n      \"unknown\": 0,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Usernames",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender/batch",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender",
                "batch"
              ]
            },
            "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"id\": \"user-1\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    },\n    {\n      \"id\": \"user-2\",\n      \"type\": \"username\",\n      \"value\": \"john_smith\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative batch response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"user-1\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    },\n    {\n      \"id\": \"user-2\",\n      \"type\": \"username\",\n      \"value\": \"john_smith\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": [\n    {\n      \"index\": 0,\n      \"id\": \"known\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"Onur\",\n          \"country\": \"TR\"\n        },\n        \"name\": \"onur\",\n        \"gender\": \"male\",\n        \"country\": \"TR\",\n        \"confidence\": 0.9,\n        \"confidence_kind\": \"observed_frequency\",\n        \"sample_count\": 100,\n        \"source\": \"dataset\",\n        \"result_status\": \"identified\",\n        \"reason\": null,\n        \"country_source\": \"dataset\",\n        \"match\": {\n          \"name\": \"onur\",\n          \"method\": \"normalized\",\n          \"scope\": \"country\",\n          \"country\": \"TR\"\n        }\n      }\n    },\n    {\n      \"index\": 1,\n      \"id\": \"missing\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"zzzxxyy\",\n          \"country\": null\n        },\n        \"name\": null,\n        \"gender\": null,\n        \"country\": null,\n        \"confidence\": null,\n        \"confidence_kind\": null,\n        \"sample_count\": null,\n        \"source\": \"none\",\n        \"result_status\": \"unknown\",\n        \"reason\": \"not_found\",\n        \"country_source\": null,\n        \"match\": {\n          \"name\": null,\n          \"method\": null,\n          \"scope\": null,\n          \"country\": null\n        }\n      }\n    },\n    {\n      \"index\": 2,\n      \"id\": \"failed\",\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"succeeded\": 2,\n      \"identified\": 1,\n      \"unknown\": 1,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative batchFailed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"user-1\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    },\n    {\n      \"id\": \"user-2\",\n      \"type\": \"username\",\n      \"value\": \"john_smith\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 502,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n  \"title\": \"ai upstream error\",\n  \"status\": 502,\n  \"detail\": \"The AI provider could not complete the request.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"ai_upstream_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"inspect_billing_before_retry\",\n  \"data\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"results\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 1,\n      \"succeeded\": 0,\n      \"identified\": 0,\n      \"unknown\": 0,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · Mixed input types",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/gender/batch",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "gender",
                "batch"
              ]
            },
            "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"items\": [\n    {\n      \"id\": \"item-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"item-2\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\",\n      \"country\": \"US\"\n    },\n    {\n      \"id\": \"item-3\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative batch response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"item-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"item-2\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\",\n      \"country\": \"US\"\n    },\n    {\n      \"id\": \"item-3\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": [\n    {\n      \"index\": 0,\n      \"id\": \"known\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"Onur\",\n          \"country\": \"TR\"\n        },\n        \"name\": \"onur\",\n        \"gender\": \"male\",\n        \"country\": \"TR\",\n        \"confidence\": 0.9,\n        \"confidence_kind\": \"observed_frequency\",\n        \"sample_count\": 100,\n        \"source\": \"dataset\",\n        \"result_status\": \"identified\",\n        \"reason\": null,\n        \"country_source\": \"dataset\",\n        \"match\": {\n          \"name\": \"onur\",\n          \"method\": \"normalized\",\n          \"scope\": \"country\",\n          \"country\": \"TR\"\n        }\n      }\n    },\n    {\n      \"index\": 1,\n      \"id\": \"missing\",\n      \"charged_credits\": 1,\n      \"data\": {\n        \"input\": {\n          \"type\": \"name\",\n          \"value\": \"zzzxxyy\",\n          \"country\": null\n        },\n        \"name\": null,\n        \"gender\": null,\n        \"country\": null,\n        \"confidence\": null,\n        \"confidence_kind\": null,\n        \"sample_count\": null,\n        \"source\": \"none\",\n        \"result_status\": \"unknown\",\n        \"reason\": \"not_found\",\n        \"country_source\": null,\n        \"match\": {\n          \"name\": null,\n          \"method\": null,\n          \"scope\": null,\n          \"country\": null\n        }\n      }\n    },\n    {\n      \"index\": 2,\n      \"id\": \"failed\",\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 2,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 3,\n      \"succeeded\": 2,\n      \"identified\": 1,\n      \"unknown\": 1,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            },
            {
              "name": "Illustrative batchFailed response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/gender/batch",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "gender",
                    "batch"
                  ]
                },
                "description": "Maximum 50 items (10 for IP trials). Each item supports name/email/username with independent country and AI options. Defaults to off; ordinary fallback costs 1, always costs 2, force costs 1 for dataset or 2 for AI. Planning failure rejects the whole batch before debit. Partial failures return 200; all failed work returns a problem with data and legacy results arrays. Each result includes charged_credits. meta.summary counts identified, unknown and failed results. Unknown predictions are successful billable items.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"items\": [\n    {\n      \"id\": \"item-1\",\n      \"type\": \"name\",\n      \"value\": \"Onur\",\n      \"country\": \"TR\"\n    },\n    {\n      \"id\": \"item-2\",\n      \"type\": \"email\",\n      \"value\": \"jane.doe@example.com\",\n      \"country\": \"US\"\n    },\n    {\n      \"id\": \"item-3\",\n      \"type\": \"username\",\n      \"value\": \"maria_92\"\n    }\n  ]\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "RFC 9457 problem. Billing uncertainty requires support; do not automatically retry.",
              "code": 502,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/problem+json"
                }
              ],
              "body": "{\n  \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n  \"title\": \"ai upstream error\",\n  \"status\": 502,\n  \"detail\": \"The AI provider could not complete the request.\",\n  \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n  \"code\": \"ai_upstream_error\",\n  \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n  \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n  \"action\": \"inspect_billing_before_retry\",\n  \"data\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"results\": [\n    {\n      \"index\": 0,\n      \"charged_credits\": 0,\n      \"error\": {\n        \"type\": \"urn:genderapi:problem:ai_upstream_error\",\n        \"title\": \"ai upstream error\",\n        \"status\": 502,\n        \"detail\": \"The AI provider could not complete the request.\",\n        \"instance\": \"urn:uuid:11111111-1111-4111-8111-111111111111\",\n        \"code\": \"ai_upstream_error\",\n        \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n        \"documentation\": \"https://api.genderapi.io/api/v2/errors\",\n        \"action\": \"inspect_billing_before_retry\"\n      }\n    }\n  ],\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 0,\n      \"remaining_credits\": 6,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    },\n    \"summary\": {\n      \"total\": 1,\n      \"succeeded\": 0,\n      \"identified\": 0,\n      \"unknown\": 0,\n      \"failed\": 1\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        }
      ]
    },
    {
      "name": "Phone validation",
      "item": [
        {
          "name": "POST · International number",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/phone/validate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "phone",
                "validate"
              ]
            },
            "description": "country is required unless number starts with +. This checks number structure, not subscriber existence.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"number\": \"+12025550123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative phone response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/phone/validate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "phone",
                    "validate"
                  ]
                },
                "description": "country is required unless number starts with +. This checks number structure, not subscriber existence.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"number\": \"+12025550123\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"valid\": false,\n    \"possible\": false,\n    \"e164\": null,\n    \"country\": null,\n    \"country_calling_code\": null\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 7,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        },
        {
          "name": "POST · National number with country",
          "request": {
            "method": "POST",
            "auth": {
              "type": "bearer",
              "bearer": [
                {
                  "key": "token",
                  "value": "{{apiKey}}",
                  "type": "string"
                }
              ]
            },
            "header": [
              {
                "key": "Accept",
                "value": "application/json, application/problem+json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/api/v2/phone/validate",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "api",
                "v2",
                "phone",
                "validate"
              ]
            },
            "description": "country is required unless number starts with +. This checks number structure, not subscriber existence.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"number\": \"2025550123\",\n  \"country\": \"US\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [
            {
              "name": "Illustrative phone response (synthetic data)",
              "originalRequest": {
                "method": "POST",
                "auth": {
                  "type": "bearer",
                  "bearer": [
                    {
                      "key": "token",
                      "value": "{{apiKey}}",
                      "type": "string"
                    }
                  ]
                },
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json, application/problem+json"
                  },
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/api/v2/phone/validate",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "api",
                    "v2",
                    "phone",
                    "validate"
                  ]
                },
                "description": "country is required unless number starts with +. This checks number structure, not subscriber existence.\n\nLive requests use normal credits: ordinary single lookups cost 1, including automatic AI fallback and unknown results. forceToGenderize costs 1 for a dataset result or 2 for AI; ai_mode always costs 2. Batch items default to dataset only and are billed individually. Phone validation costs 1. Usage and service requests are free. Every repeat is a new operation; no automatic retries are configured.",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"number\": \"2025550123\",\n  \"country\": \"US\"\n}",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  }
                }
              },
              "status": "Completed. Unknown predictions are valid, billed results. Batch may contain item errors; only successful items are billed.",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": "{\n  \"data\": {\n    \"valid\": false,\n    \"possible\": false,\n    \"e164\": null,\n    \"country\": null,\n    \"country_calling_code\": null\n  },\n  \"meta\": {\n    \"request_id\": \"11111111-1111-4111-8111-111111111111\",\n    \"duration_ms\": 12,\n    \"access\": {\n      \"mode\": \"ip_trial\",\n      \"reason\": \"api_key_missing\"\n    },\n    \"usage\": {\n      \"charged_credits\": 1,\n      \"remaining_credits\": 7,\n      \"billing_status\": \"confirmed\",\n      \"resets_at\": \"2026-09-26T12:00:00.000Z\",\n      \"limit\": 10,\n      \"period_seconds\": 86400\n    }\n  }\n}",
              "_postman_previewlanguage": "json"
            }
          ]
        }
      ]
    }
  ]
}