List provider and network models
Read the ShareAI Provider API network catalog, your provider catalog and exact model details using provider_models:read.
On this page
Use the network catalog to discover available model records and your catalog to inspect models associated with the authenticated provider. A catalog entry is distinct from a device actively sharing that model.


https://api.shareai.now/api/v1/console/provider/model-catalogRead the network model catalog.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: provider UUID and provider access token
- Required scope
provider_models:read
https://api.shareai.now/api/v1/console/provider/model-catalog/myRead this provider’s model catalog.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: provider UUID and provider access token
- Required scope
provider_models:read
Query parameters#
| Parameter | Use |
|---|---|
page | Pagination page, starting at 1. |
limit | Requested page size; the server applies its supported bounds. |
search | Filter model names or identifiers. |
type | Optional supported catalog-type filter on the network catalog. |
cURL
curl --fail-with-body --request GET \
"https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20" \
-u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN"
Python
import json
import os
import urllib.request
import base64
credentials = os.environ["PROVIDER_UUID"] + ":" + os.environ["PROVIDER_ACCESS_TOKEN"]
headers = {"Authorization": "Basic " + base64.b64encode(credentials.encode()).decode()}
request = urllib.request.Request('https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20', headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/console/provider/model-catalog/my?page=1&limit=20";
const credentials = `${process.env.PROVIDER_UUID}:${process.env.PROVIDER_ACCESS_TOKEN}`;
const headers: Record = {
Authorization: `Basic ${Buffer.from(credentials).toString("base64")}`,
};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
Read an exact model#
https://api.shareai.now/api/v1/console/provider/model-catalog/my/modelLook up an exact full_model_identifier.
- Base URL
https://api.shareai.now- Authentication
- HTTP Basic: provider UUID and provider access token
- Required scope
provider_models:read
cURL
curl --get --fail-with-body https://api.shareai.now/api/v1/console/provider/model-catalog/my/model \
-u "$PROVIDER_UUID:$PROVIDER_ACCESS_TOKEN" \
--data-urlencode "full_model_identifier=$MODEL_IDENTIFIER"
Interpret the response#
List responses identify the selected catalog and return its items. A known model can be returned by an exact lookup even when it has not been added to the provider. Check the returned association and permission state before offering a pricing or sharing action.
Keep identifiers exact#
Do not rebuild an identifier from a model’s display name. Preserve its creator/model/tag punctuation, and URL-encode query values. Use the provider’s current permissions and the model’s access terms when deciding whether it can be served.
Last updated September 15, 2026