{
  "openapi": "3.1.0",
  "info": {
    "title": "Checky \u2014 Verify Phone Number API",
    "version": "Unversioned",
    "description": "Validate and normalize phone numbers, look up carrier and location metadata, check batches and find numbers in text.",
    "x-pricing-model": "payg",
    "x-free-tier-calls": 0,
    "x-docs-url": "",
    "x-dakidarts-contract-status": "published",
    "x-dakidarts-execution-status": "source-only"
  },
  "servers": [
    {
      "url": "https://api.dakidarts.com/checky-phone",
      "description": "Dakidarts direct gateway"
    }
  ],
  "tags": [
    {
      "name": "Operations",
      "description": "Operations endpoints sourced from the Checky \u2014 Verify Phone Number API implementation."
    },
    {
      "name": "Phone verification",
      "description": "Phone verification endpoints sourced from the Checky \u2014 Verify Phone Number API implementation."
    }
  ],
  "paths": {
    "/status": {
      "get": {
        "summary": "Ping",
        "description": "Returns Checky Phone service health.",
        "operationId": "checky-phone_get_status",
        "tags": [
          "Operations"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "API is online"
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true,
        "x-dakidarts-sample-response": {
          "status": "API is online"
        }
      },
      "post": {
        "summary": "Ping",
        "description": "Returns Checky Phone service health.",
        "operationId": "checky-phone_post_status",
        "tags": [
          "Operations"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "example": {
                    "status": "API is online"
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true,
        "x-dakidarts-sample-response": {
          "status": "API is online"
        }
      }
    },
    "/verify": {
      "get": {
        "summary": "Verify Phone",
        "description": "Validates a phone number and returns its normalized number and type.",
        "operationId": "checky-phone_get_verify",
        "tags": [
          "Phone verification"
        ],
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "required": true,
            "description": "Phone number to validate or look up; include the international prefix when available.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": true,
            "description": "ISO 3166-1 alpha-2 region code used to parse a national-format phone number.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "Language/locale used for localized phone metadata.",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "valid": {
                      "type": "boolean"
                    },
                    "carrier": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "country": {
                      "type": "integer"
                    },
                    "location": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "timezone": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "phone_type": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "phone_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "emergency_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "country_mobile_code": {
                      "type": "integer"
                    },
                    "can_be_dialled_internationally": {
                      "description": "Dynamic source value; no concrete response example is published."
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/verify/batch": {
      "post": {
        "summary": "Verify Phone Batch",
        "description": "Validates a list of phone numbers and returns independent results.",
        "operationId": "checky-phone_post_verify_batch",
        "tags": [
          "Phone verification"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "array",
                    "example": [
                      "+12025550123",
                      "+442079460123"
                    ],
                    "items": {
                      "type": "string"
                    }
                  },
                  "country": {
                    "type": "string"
                  },
                  "lang": {
                    "type": "string",
                    "default": "en"
                  }
                },
                "required": [
                  "country",
                  "phone"
                ],
                "example": {
                  "lang": "en",
                  "phone": [
                    "+12025550123",
                    "+12025550124"
                  ],
                  "country": "US"
                }
              }
            }
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/verify/post": {
      "post": {
        "summary": "Verify Phone Post",
        "description": "Validates one phone number from a JSON request body.",
        "operationId": "checky-phone_post_verify_post",
        "tags": [
          "Phone verification"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "carrier": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "country": {
                      "type": "integer"
                    },
                    "location": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "timezone": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "phone_type": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "phone_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "emergency_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "country_mobile_code": {
                      "type": "integer"
                    },
                    "can_be_dialled_internationally": {
                      "description": "Dynamic source value; no concrete response example is published."
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "lang": {
                    "type": "string",
                    "default": "en"
                  }
                },
                "required": [
                  "country",
                  "phone"
                ],
                "example": {
                  "lang": "en",
                  "phone": "+12025550123",
                  "country": "US"
                }
              }
            }
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/carrier": {
      "get": {
        "summary": "Get Carrier",
        "description": "Looks up carrier, geographic description, and time zones for a phone number.",
        "operationId": "checky-phone_get_carrier",
        "tags": [
          "Phone verification"
        ],
        "parameters": [
          {
            "name": "phone",
            "in": "query",
            "required": true,
            "description": "Phone number to validate or look up; include the international prefix when available.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": true,
            "description": "ISO 3166-1 alpha-2 region code used to parse a national-format phone number.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "Language/locale used for localized phone metadata.",
            "schema": {
              "type": "string",
              "default": "en"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "carrier": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "location": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "country_code": {
                      "type": "integer"
                    },
                    "phone_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/carrier/batch": {
      "post": {
        "summary": "Get Carrier Batch",
        "description": "Looks up carrier information for a list of phone numbers.",
        "operationId": "checky-phone_post_carrier_batch",
        "tags": [
          "Phone verification"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "array",
                    "example": [
                      "+12025550123",
                      "+442079460123"
                    ],
                    "items": {
                      "type": "string"
                    }
                  },
                  "country": {
                    "type": "string"
                  },
                  "lang": {
                    "type": "string",
                    "default": "en"
                  }
                },
                "required": [
                  "country",
                  "phone"
                ],
                "example": {
                  "lang": "en",
                  "phone": [
                    "+12025550123",
                    "+12025550124"
                  ],
                  "country": "US"
                }
              }
            }
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/carrier/post": {
      "post": {
        "summary": "Get Carrier Post",
        "description": "Looks up carrier information from a JSON request body.",
        "operationId": "checky-phone_post_carrier_post",
        "tags": [
          "Phone verification"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "carrier": {
                      "description": "Dynamic source value; no concrete response example is published."
                    },
                    "location": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "country_code": {
                      "type": "integer"
                    },
                    "phone_number": {
                      "description": "Dynamic source value; no concrete response example is published."
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "lang": {
                    "type": "string"
                  }
                },
                "required": [
                  "country",
                  "phone"
                ],
                "example": {
                  "lang": "en",
                  "phone": "+12025550123",
                  "country": "US"
                }
              }
            }
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    },
    "/finder": {
      "post": {
        "summary": "Find Phone Numbers",
        "description": "Finds phone numbers in text using the supplied country context.",
        "operationId": "checky-phone_post_finder",
        "tags": [
          "Phone verification"
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "phone_numbers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "4XX": {
            "description": "Client error"
          },
          "5XX": {
            "description": "Upstream or gateway error"
          },
          "503": {
            "description": "No live upstream is configured. Sample responses are preview-only."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  }
                },
                "required": [
                  "country",
                  "text"
                ],
                "example": {
                  "text": "Call the demo line at +1 202-555-0123.",
                  "country": "US"
                }
              }
            }
          }
        },
        "x-dakidarts-execution-status": "source-only",
        "x-dakidarts-source-contract": true
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ]
}