Catalog

List compatible devices

Returns the full hierarchical catalog of devices that are compatible with eSIM functionality. The catalog is organized by brand, with categories and model lists. Brands like Apple and Samsung include sub-categories (e.g., iPhone, iPad, Galaxy S Series). Other brands list models directly.

get/catalog/devices

Authorization

Authorization: Bearer {token} — an OAuth2 access token from the client-credentials flow. How authentication works

Responses

200Hierarchical device catalogapplication/json

Show response body

dataobject

Device catalog organized by brand. Values are either arrays of model names or objects with sub-categories.

401Unauthorized - missing or invalid API key 403Forbidden - client does not have access to this resource 429Rate limit exceeded 500Internal server error

Request

curl https://connect.firsty.app/api/v3/catalog/devices \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.firsty.app/api/v3/catalog/devices', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.firsty.app/api/v3/catalog/devices",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.firsty.app/api/v3/catalog/devices', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.firsty.app/api/v3/catalog/devices"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

curl https://connect.test.firsty.app/api/v3/catalog/devices \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.test.firsty.app/api/v3/catalog/devices', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.test.firsty.app/api/v3/catalog/devices",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.test.firsty.app/api/v3/catalog/devices', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.test.firsty.app/api/v3/catalog/devices"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Response

{
  "data": {
    "Apple": {
      "iPhone": [
        "iPhone 17",
        "iPhone 17 Pro",
        "iPhone 17 Pro Max",
        "iPhone Air",
        "iPhone 16",
        "iPhone 16e",
        "iPhone 16 Plus",
        "iPhone 16 Pro",
        "iPhone 16 Pro Max",
        "iPhone 15",
        "iPhone 15 Plus",
        "iPhone 15 Pro",
        "iPhone 15 Pro Max",
        "iPhone SE (2020)",
        "iPhone SE (2022)"
      ],
      "iPad": [
        "iPad (from 7th generation)",
        "iPad Air (from 3rd generation)",
        "iPad Pro 11-inch (from 1st generation)",
        "iPad Pro 12.9-inch (from 3rd generation)",
        "iPad Mini (from 5th generation)"
      ]
    },
    "Samsung": {
      "Galaxy_S_Series": [
        "Galaxy S25 Ultra",
        "Galaxy S25 Slim",
        "Galaxy S25+",
        "Galaxy S25 Edge",
        "Galaxy S25",
        "Galaxy S24 Ultra",
        "Galaxy S24+",
        "Galaxy S24",
        "Galaxy S24 FE"
      ],
      "Galaxy_Z_Series": [
        "Galaxy Z Fold 6",
        "Galaxy Z Fold 5",
        "Galaxy Z Fold 4",
        "Galaxy Z Flip6",
        "Galaxy Z Flip 5",
        "Galaxy Z Flip 4",
        "Galaxy Z TriFold"
      ],
      "Galaxy_A_Series": [
        "Galaxy A56",
        "Galaxy A55 5G",
        "Galaxy A54 5G",
        "Galaxy A36",
        "Galaxy A35 5G"
      ],
      "Galaxy_Note_Series": [
        "Galaxy Note 20 Ultra 5G",
        "Galaxy Note 20 Ultra",
        "Galaxy Note 20 5G",
        "Galaxy Note 20"
      ],
      "Other": [
        "Galaxy XCover7 Pro"
      ]
    },
    "Google_Pixel": [
      "Pixel 10",
      "Pixel 10 Pro",
      "Pixel 10 Pro Fold",
      "Pixel 9",
      "Pixel 9 Pro",
      "Pixel 9 Pro XL",
      "Pixel 9 Pro Fold",
      "Pixel 8",
      "Pixel 8 Pro",
      "Pixel 7",
      "Pixel 7 Pro",
      "Pixel Fold"
    ],
    "Motorola": [
      "Razr (2019/2022/2024/2025)",
      "Razr+",
      "Razr 40/50/60",
      "Razr 40 Ultra",
      "Edge 60/50/40 Series",
      "Edge+",
      "Moto G34/G35/G53/G54/G55/G75/G85",
      "ThinkPhone 25"
    ],
    "Xiaomi": [
      "Xiaomi 15/14/13/12T Pro Series",
      "Xiaomi 14T/13T Pro",
      "Redmi Note 14 Pro+",
      "Redmi Note 13 Pro+",
      "Poco X7",
      "Poco F8 Ultra"
    ],
    "Others": {
      "Oppo": [
        "Find N5",
        "Find X8 Pro",
        "Reno 15 Pro"
      ],
      "Sony": [
        "Xperia 1 VI",
        "Xperia 5 V",
        "Xperia 10 VI"
      ],
      "Vivo": [
        "X200 Pro",
        "V40",
        "Watch 5"
      ],
      "Honor": [
        "Magic7 Pro",
        "Magic V3",
        "Honor 200 Pro"
      ],
      "OnePlus": [
        "OnePlus 15",
        "OnePlus 13",
        "OnePlus 12",
        "OnePlus Open"
      ],
      "Laptops": [
        "Surface Pro 9",
        "ThinkPad X1 Carbon Gen 9",
        "HP Elitebook G5",
        "Dell Latitude 9410"
      ]
    }
  }
}

{
  "type": "https://developers.firsty.app/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing bearer token"
}