> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterid.co.ug/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /catalog

> List supported verification products, their required fields, allowed selections, and current prices in UGX.

`GET https://masterid.me/api/public/v1/catalog`

Returns the current catalog of supported verification products for your workspace. Use this to discover which products are available, which fields each requires, whether any fields accept specific selection values, and the current wallet charge in UGX.

All products require the fields listed in the catalog. No file uploads are supported in v1.

For a human-readable reference of each product and its inputs, see [Products](https://docs.masterid.co.ug/products.md).

## Authentication

**X-API-Key** `string` *required*

Your workspace API key.

**X-API-Secret** `string` *required*

Your workspace API secret.

## Response

**id** `string` *required*

The API request ID.

**data** `object` *required*

**properties**

**products** `array`

The list of available verification products. Each entry describes the product identifier, required fields, allowed selections, and price. The exact shape of each product entry is determined by the catalog at request time.

> [!NOTE]
>
> The full response structure inside `data` is dynamic and reflects the current catalog. Do not hardcode product slugs or prices. Poll this endpoint when your integration starts, or cache the result with a sensible TTL.

## Status codes

| Code | Meaning |
| - | - |
| 200 | Catalog returned. |
| 401 | Missing or invalid credentials. |
| 429 | Rate limit reached. |

```bash cURL theme={null}
curl -X GET "https://masterid.me/api/public/v1/catalog" \
  -H "X-API-Key: $MASTERID_API_KEY" \
  -H "X-API-Secret: $MASTERID_API_SECRET" \
  -H "Content-Type: application/json"
```

```javascript Node.js theme={null}
const response = await fetch("https://masterid.me/api/public/v1/catalog", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.MASTERID_API_KEY,
    "X-API-Secret": process.env.MASTERID_API_SECRET,
    "Content-Type": "application/json",
  },
});
const result = await response.json();
console.log(result);
```

```python Python theme={null}
import os
import requests

response = requests.get(
    "https://masterid.me/api/public/v1/catalog",
    headers={
        "X-API-Key": os.environ["MASTERID_API_KEY"],
        "X-API-Secret": os.environ["MASTERID_API_SECRET"],
        "Content-Type": "application/json",
    },
)
print(response.json())
```

```json 200 theme={null}
{
  "id": "<REQUEST_ID>",
  "data": {
    "products": [
      {
        "slug": "tin",
        "name": "Individual TIN Verification",
        "fields": [
          {
            "name": "tin",
            "type": "text",
            "required": true
          }
        ],
        "price_ugx": 1500
      }
    ]
  }
}
```


## Related topics

- [Products and fields](https://docs.masterid.co.ug/products.md)
- [MasterID Integration API](https://docs.masterid.co.ug/index.md)
- [Quickstart](https://docs.masterid.co.ug/quickstart.md)
- [API Overview](https://docs.masterid.co.ug/api-reference/overview.md)
- [Go-live checklist](https://docs.masterid.co.ug/guides/go-live-checklist.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.