---
title: "List all user-submitted custom components"
method: GET
path: "/api/admin/custom-components"
tags: ["admin-catalog-tools"]
---

# List all user-submitted custom components

`GET /api/admin/custom-components`

## Request

- Base URL: `https://voltplan.app`
- URL: `https://voltplan.app/api/admin/custom-components`
- Auth: HTTP bearer

Returns every `custom_components` record, fetched with the PocketBase superuser client (`getFullList`, batch size 500), newest first (`sort: -created`). There is no pagination; `totalItems` equals `items.length`.

## Response `200`

All custom components.

- AdminCatalogCustomComponentList
  - `items` AdminCatalogCustomComponent[], required
    - `id` string, required
    - `collectionId` string, required
    - `collectionName` 'custom_components', required
    - `name` string, required
    - `wattage` number
    - `type` string: `load`, `battery`, `power`, `charger`, `inverter` or `transformer`; `""` when unset.
    - `voltage_in` number
    - `voltage_out` number
    - `voltage_in_type` string: `dc`, `ac`, or `""` when unset.
    - `voltage_out_type` string: `dc`, `ac`, or `""` when unset.
    - `description` string
    - `product_url` string
    - `user_email` string
    - `approved` boolean
    - `approved_at` string: Approval time; `""` when unset. PocketBase datetime `YYYY-MM-DD HH:MM:SS.sssZ` (space, not `T`).
    - `created` string, required: Creation time. PocketBase datetime `YYYY-MM-DD HH:MM:SS.sssZ` (space, not `T`).
    - `updated` string, required: Last update time. PocketBase datetime `YYYY-MM-DD HH:MM:SS.sssZ` (space, not `T`).
  - `totalItems` integer, required: Equals `items.length`.

## Other responses

- `403`: Admin access required. Returned for a missing, invalid or expired bearer token as well as for a valid token whose user lacks `is_admin=true`; admin endpoints never answer 401.
- `500`: The PocketBase query failed or the admin credentials (`POCKETBASE_ADMIN_EMAIL`, `POCKETBASE_ADMIN_PASSWORD`) are not configured.

---

[API](https://skmtc.dev/voltplan/apis/voltplan-api.md) · [All operations](https://skmtc.dev/voltplan/apis/voltplan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voltplan/apis/voltplan-api/revisions/575b86a7af92?raw)