{
  "openapi": "3.0.1",
  "info": {
    "title": "Phone Carrier Compatibility Checker & BYOD Tool",
    "description": "Check whether an unlocked, imported, or travel phone will work on a carrier using official evidence across 30 markets and 80 carriers. Built for BYOD, activation, resale, bulk checks for 1 to 100 phones, automation, and AI agents; returns UNKNOWN instead of guessing when evidence is insufficient.",
    "version": "0.1",
    "x-build-id": "ffUecIuxuiDVZTUyp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/factrelay~global-phone-compatibility-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-factrelay-global-phone-compatibility-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/factrelay~global-phone-compatibility-checker/runs": {
      "post": {
        "operationId": "runs-sync-factrelay-global-phone-compatibility-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/factrelay~global-phone-compatibility-checker/run-sync": {
      "post": {
        "operationId": "run-sync-factrelay-global-phone-compatibility-checker",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "brand",
          "model",
          "country",
          "carrier"
        ],
        "properties": {
          "brand": {
            "title": "Phone brand",
            "type": "string",
            "description": "Choose a common brand or type another phone brand."
          },
          "model": {
            "title": "Phone model",
            "type": "string",
            "description": "Choose a suggested model or type the exact phone model."
          },
          "country": {
            "title": "Use in country",
            "type": "string",
            "description": "Where you want to use the phone. Suggested markets are currently supported; API aliases remain accepted."
          },
          "carrier": {
            "title": "Carrier to use",
            "type": "string",
            "description": "Choose a carrier labeled for the same country selected above. Suggestions are grouped by market; supported aliases remain accepted in API input."
          },
          "variant": {
            "title": "Regional / hardware variant (optional)",
            "type": "string",
            "description": "Optional. Enter an exact regional or hardware variant/model code only if you know it. Purchase country alone does not identify the hardware variant."
          },
          "tac": {
            "title": "TAC (optional, 8 digits)",
            "pattern": "^[0-9]{8}$",
            "type": "string",
            "description": "Optional eight-digit Type Allocation Code only. Never enter a full IMEI."
          },
          "additional_queries": {
            "title": "Add more phone checks (optional)",
            "minItems": 1,
            "maxItems": 99,
            "type": "array",
            "description": "Optional bulk mode. Add up to 99 more phones; each result is returned as its own dataset item.",
            "items": {
              "type": "object",
              "properties": {
                "brand": {
                  "title": "Phone brand",
                  "description": "The manufacturer or consumer brand of the phone.",
                  "type": "string",
                  "editor": "select",
                  "enumSuggestedValues": [
                    "Apple",
                    "Google",
                    "OPPO",
                    "OnePlus",
                    "Samsung"
                  ]
                },
                "model": {
                  "title": "Phone model",
                  "description": "The phone model to check.",
                  "type": "string",
                  "editor": "select",
                  "enumSuggestedValues": [
                    "13",
                    "A79 5G",
                    "Galaxy S23 Ultra",
                    "Galaxy S25",
                    "Pixel 9",
                    "Pixel 9a",
                    "S23 Ultra",
                    "iPhone 11 Pro",
                    "iPhone 12 Pro Max",
                    "iPhone 15"
                  ]
                },
                "country": {
                  "title": "Use in country",
                  "description": "The country where the carrier operates.",
                  "type": "string",
                  "editor": "select",
                  "enumSuggestedValues": [
                    "Australia",
                    "Austria",
                    "Belgium",
                    "Brazil",
                    "Canada",
                    "France",
                    "Germany",
                    "Hong Kong",
                    "India",
                    "Indonesia",
                    "Italy",
                    "Japan",
                    "Malaysia",
                    "Mexico",
                    "Netherlands",
                    "New Zealand",
                    "Philippines",
                    "Poland",
                    "Portugal",
                    "Saudi Arabia",
                    "Singapore",
                    "South Africa",
                    "South Korea",
                    "Spain",
                    "Switzerland",
                    "Taiwan",
                    "Thailand",
                    "United Arab Emirates",
                    "United Kingdom",
                    "United States"
                  ]
                },
                "carrier": {
                  "title": "Carrier to use",
                  "description": "Choose a carrier labeled for the same country selected above.",
                  "type": "string",
                  "editor": "select",
                  "enumSuggestedValues": [
                    "Optus",
                    "TPG",
                    "Telstra",
                    "Vodafone",
                    "A1",
                    "Magenta",
                    "Orange",
                    "Proximus",
                    "Claro",
                    "TIM",
                    "Vivo",
                    "Bell",
                    "Rogers",
                    "TELUS",
                    "Virgin Plus",
                    "Bouygues Telecom",
                    "SFR",
                    "Deutsche Telekom",
                    "O2",
                    "China Mobile HK",
                    "csl",
                    "Airtel",
                    "Jio",
                    "Vi",
                    "IM3",
                    "Telkomsel",
                    "WINDTRE",
                    "NTT docomo",
                    "Rakuten Mobile",
                    "SoftBank",
                    "au",
                    "CelcomDigi",
                    "Maxis",
                    "U Mobile",
                    "Movistar",
                    "Telcel",
                    "KPN",
                    "Odido",
                    "2degrees",
                    "One NZ",
                    "Globe",
                    "Smart",
                    "Plus",
                    "T-Mobile",
                    "MEO",
                    "NOS",
                    "Mobily",
                    "stc",
                    "M1",
                    "SIMBA",
                    "Singtel",
                    "StarHub",
                    "MTN",
                    "Vodacom",
                    "KT",
                    "SK Telecom",
                    "Salt",
                    "Sunrise",
                    "Swisscom",
                    "Chunghwa Telecom",
                    "Taiwan Mobile",
                    "AIS",
                    "True-dtac",
                    "du",
                    "EE",
                    "Three",
                    "AT&T",
                    "Google Fi",
                    "Tello",
                    "Verizon"
                  ],
                  "enumTitles": [
                    "Australia — Optus",
                    "Australia — TPG",
                    "Australia — Telstra",
                    "Australia / Germany / Italy / Portugal / Spain / United Kingdom — Vodafone",
                    "Austria — A1",
                    "Austria — Magenta",
                    "Belgium / France / Poland / Spain — Orange",
                    "Belgium — Proximus",
                    "Brazil — Claro",
                    "Brazil — TIM",
                    "Brazil — Vivo",
                    "Canada — Bell",
                    "Canada — Rogers",
                    "Canada — TELUS",
                    "Canada — Virgin Plus",
                    "France — Bouygues Telecom",
                    "France — SFR",
                    "Germany — Deutsche Telekom",
                    "Germany / United Kingdom — O2",
                    "Hong Kong — China Mobile HK",
                    "Hong Kong — csl",
                    "India — Airtel",
                    "India — Jio",
                    "India — Vi",
                    "Indonesia — IM3",
                    "Indonesia — Telkomsel",
                    "Italy — WINDTRE",
                    "Japan — NTT docomo",
                    "Japan — Rakuten Mobile",
                    "Japan — SoftBank",
                    "Japan — au",
                    "Malaysia — CelcomDigi",
                    "Malaysia — Maxis",
                    "Malaysia — U Mobile",
                    "Mexico — Movistar",
                    "Mexico — Telcel",
                    "Netherlands — KPN",
                    "Netherlands — Odido",
                    "New Zealand — 2degrees",
                    "New Zealand — One NZ",
                    "Philippines — Globe",
                    "Philippines — Smart",
                    "Poland — Plus",
                    "Poland / United States — T-Mobile",
                    "Portugal — MEO",
                    "Portugal — NOS",
                    "Saudi Arabia — Mobily",
                    "Saudi Arabia — stc",
                    "Singapore — M1",
                    "Singapore — SIMBA",
                    "Singapore — Singtel",
                    "Singapore — StarHub",
                    "South Africa — MTN",
                    "South Africa — Vodacom",
                    "South Korea — KT",
                    "South Korea — SK Telecom",
                    "Switzerland — Salt",
                    "Switzerland — Sunrise",
                    "Switzerland — Swisscom",
                    "Taiwan — Chunghwa Telecom",
                    "Taiwan — Taiwan Mobile",
                    "Thailand — AIS",
                    "Thailand — True-dtac",
                    "United Arab Emirates — du",
                    "United Kingdom — EE",
                    "United Kingdom — Three",
                    "United States — AT&T",
                    "United States — Google Fi",
                    "United States — Tello",
                    "United States — Verizon"
                  ]
                },
                "variant": {
                  "title": "Regional or hardware variant",
                  "description": "Optional regional or hardware variant for a more specific check.",
                  "type": "string"
                },
                "tac": {
                  "title": "Type Allocation Code (TAC)",
                  "description": "Optional eight-digit TAC only; do not provide a full IMEI.",
                  "type": "string",
                  "pattern": "^[0-9]{8}$"
                }
              },
              "required": [
                "brand",
                "model",
                "country",
                "carrier"
              ],
              "additionalProperties": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}