> ## Documentation Index
> Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Models

Returns a list of published charger models, ordered by vendor then name. This endpoint does not require authentication.

## Response

<ResponseField name="data" type="array">
  Array of model objects.

  <Expandable title="model">
    <ResponseField name="id" type="integer">
      The numeric ID of the model.
    </ResponseField>

    <ResponseField name="vendor" type="string">
      The vendor name. Resolved from the canonical vendor when the model is linked to one, otherwise the raw vendor string stored on the model.
    </ResponseField>

    <ResponseField name="name" type="string">
      The model name.
    </ResponseField>

    <ResponseField name="display_name" type="string">
      The customer-facing display name for the model. Can be `null`.
    </ResponseField>

    <ResponseField name="is_dc" type="boolean">
      Whether the model is a DC charger. Can be `null` if not set.
    </ResponseField>

    <ResponseField name="is_mid" type="boolean">
      Whether the model has MID-certified metering. Can be `null` if not set.
    </ResponseField>

    <ResponseField name="image_url" type="string">
      The publicly accessible URL for the model's image, or `null` when no image is set.
    </ResponseField>

    <ResponseField name="serial_format" type="object">
      The expected shape of the model's serial number, or `null` when not configured.

      <Expandable title="serial_format">
        <ResponseField name="type" type="string">
          Either `numeric` or `alphanumeric`.
        </ResponseField>

        <ResponseField name="length" type="integer">
          The exact required length. Only present when `type` is `numeric`.
        </ResponseField>

        <ResponseField name="max_length" type="integer">
          The maximum allowed length. Only present when `type` is `alphanumeric`.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="identity_prefix" type="string">
      An optional prefix prepended to the charger identity for this model (e.g. `VT_`). Can be `null`.
    </ResponseField>

    <ResponseField name="help_article_id" type="string">
      The identifier of the associated Intercom help article. Can be `null`.
    </ResponseField>

    <ResponseField name="requires_pincode" type="boolean">
      Whether setting up a charger of this model requires a PIN code.
    </ResponseField>

    <ResponseField name="wifi_setup" type="boolean">
      Whether the model's setup flow includes a Wi-Fi configuration step.
    </ResponseField>

    <ResponseField name="certified" type="boolean">
      Whether the model is certified.
    </ResponseField>

    <ResponseField name="capabilities" type="object">
      The settings/capabilities supported by this model. `lock` and `autostart` are generic and always `true`; the rest are derived from the model-specific support classes so they can never drift from what the firmware actually supports.

      <Expandable title="capabilities">
        <ResponseField name="lock" type="boolean">
          Always `true`.
        </ResponseField>

        <ResponseField name="autostart" type="boolean">
          Always `true`.
        </ResponseField>

        <ResponseField name="setup" type="boolean">
          Whether the model supports guided setup.
        </ResponseField>

        <ResponseField name="socket_lock" type="boolean">
          Whether the model supports socket locking.
        </ResponseField>

        <ResponseField name="display_led" type="boolean">
          Whether the model supports reading the display LED state.
        </ResponseField>

        <ResponseField name="nanogrid" type="boolean">
          Whether the model supports NanoGrid.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>