# SenPrints Seller API: Get the list of catalogs

## Base URLs

- `https://api-sg.senprints.net` (Production)
- `https://apis.dev.senprints.net` (Development)

## Authentication

Send `Authorization: Bearer <API key>` with every request.
Get an API key in the seller dashboard -> Settings -> General -> Get API Key: [seller.senprints.com](https://seller.senprints.com/settings/general) for production, [seller.senprints.xyz](https://seller.senprints.xyz/settings/general) for development; a key works on its own environment only (account owner only, valid for one year). A missing key answers HTTP 406 (`api_key_absent`), an invalid or expired key HTTP 401 (`api_key_invalid`, `api_key_expired`).

## Get the list of catalogs

`GET /seller-api/catalog`

Retrieve the list of catalogs available in the system. The tags below document GET /seller-api/catalog for Scribe.
Products are grouped by category. A product's `id` is the `template_id` of POST /seller-api/orders and the `id`
of GET /seller-api/catalog/info; `options` are the values an order line picks from, and `print_spaces` the names
its `designs[].print_space` uses (sizes in pixels).

### Responses

- `200`

  ```json
  {
      "success": true,
      "message": null,
      "data": [
          {
              "id": 12,
              "name": "T-Shirts",
              "full_name": "T-Shirts",
              "slug": "t-shirts",
              "products": [
                  {
                      "id": 101,
                      "name": "Unisex Standard T-Shirt",
                      "sku": "AMST",
                      "thumb_url": "https://example.com/thumb.jpg",
                      "base_cost": 8.5,
                      "base_costs": null,
                      "suggested_price": 24.99,
                      "options": {
                          "color": [
                              "white",
                              "black",
                              "navy"
                          ],
                          "size": [
                              "s",
                              "m",
                              "l",
                              "xl",
                              "2xl"
                          ]
                      },
                      "print_spaces": [
                          {
                              "name": "front",
                              "width": 4200,
                              "height": 4800
                          },
                          {
                              "name": "back",
                              "width": 4200,
                              "height": 4800
                          }
                      ],
                      "extra_print_cost": 2,
                      "priority": null,
                      "mockup_type": "flat",
                      "attributes": null,
                      "pricing_mode": "adjust_price",
                      "full_printed": 0,
                      "status": "active",
                      "market_location": null,
                      "system_type": "regular",
                      "quantity": null,
                      "default_option": null,
                      "custom_options": null,
                      "colors": [
                          {
                              "name": "white",
                              "hex_code": "#ffffff"
                          },
                          {
                              "name": "black",
                              "hex_code": "#000000"
                          },
                          {
                              "name": "navy",
                              "hex_code": "#1f2a44"
                          }
                      ],
                      "sellable_option_types": [],
                      "mockups": [],
                      "selected": false,
                      "mockups_psd": []
                  }
              ],
              "child_menu": []
          }
      ]
  }
  ```

- `401` Invalid or expired API key

  ```json
  {
      "success": false,
      "error": "api_key_invalid"
  }
  ```