> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/categories/category-covers.md).

# Category Covers

The artwork shown on a category tile. Covers come from two places, and both are listed together because an admin picking one does not care which is which:

* Vome's own set, shared by every organization
* artwork your organization has uploaded for itself

Adding a cover means uploading an image, so that stays in Vome. This endpoint is read-only.

#### Endpoint

```plaintext
GET api/category-covers/
GET api/category-covers/{category_cover_id}/
```

#### Supported query parameters

| Parameter   | Description                                     |
| ----------- | ----------------------------------------------- |
| `page`      | Page number.                                    |
| `page_size` | Results per page, up to 100.                    |
| `search`    | Matches part of a cover name, case-insensitive. |

#### Example response

```json
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "8b1f0d1c-9a1e-4a3f-9d21-0f0a2f5c77aa",
      "name": "Volunteering",
      "image_url": "https://.../opportunity_theme_images/volunteering.png",
      "is_vome_default": true
    },
    {
      "id": "2c7d4e9a-1b2c-4d3e-8f90-a1b2c3d4e5f6",
      "name": "Our Branding",
      "image_url": "https://.../opportunity_theme_images/ours.png",
      "is_vome_default": false
    }
  ]
}
```

* `is_vome_default` is `true` for Vome's shared artwork and `false` for your organization's own.
* `image_url` is `null` when the stored image cannot be resolved.

Use either the `id` or the `name` when creating a category. See [Create categories](/resources/categories/write-operations/create-categories.md).