{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/generect-com/json-schema/generect-com-phone-find-response-schema.json",
  "title": "PhoneFindResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/generect-com-10-phone-api-openapi.yml#/components/schemas/PhoneFindResponse",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "lead_id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Resolved lead identifier, when the input matched a lead."
        },
        "phone": {
          "type": "object",
          "properties": {
            "number": {
              "type": [
                "string",
                "null"
              ],
              "description": "Phone number in E.164 format; null when not found."
            },
            "status": {
              "type": "string",
              "enum": [
                "FOUND",
                "NOT_FOUND"
              ]
            },
            "type": {
              "type": "string",
              "description": "Number type (mobile, fixed_line, voip, ...). Present when found."
            },
            "country": {
              "type": "string",
              "description": "ISO country code. Present when found."
            }
          }
        }
      }
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "$defs": {
    "Meta": {
      "type": "object",
      "description": "Operation metadata returned in every data/meta response.",
      "required": [
        "amount_charged"
      ],
      "properties": {
        "amount_charged": {
          "type": "number",
          "description": "Actual amount charged for this request in USD, computed from your pricing tier. 0 for free operations and for not-found results (No Data — No Charge)."
        },
        "status": {
          "type": "string",
          "description": "Set to \"error\" when the operation finished with an error."
        },
        "error": {
          "type": "string",
          "description": "Error details; present only when the operation failed."
        },
        "time_cached": {
          "type": "string",
          "format": "date-time",
          "description": "When the cached result set was originally collected (returned by database company search when results are served from a previous identical search)."
        },
        "free_tier": {
          "type": "object",
          "description": "Present only on a database lead or company search sent with `\"detail\": \"thin\"`: where your account stands against today's free row quota. The quota resets at 00:00 UTC.",
          "properties": {
            "detail": {
              "type": "string",
              "enum": [
                "thin"
              ]
            },
            "daily_rows": {
              "type": "integer",
              "description": "Free thin rows per account per UTC day."
            },
            "rows_used_today": {
              "type": "integer",
              "description": "Thin rows returned to your account today, this page included."
            },
            "rows_left_today": {
              "type": "integer",
              "description": "Thin rows your account can still take today."
            }
          }
        }
      }
    }
  }
}