> ## 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.

# Import Cards

Imports multiple RFID cards from a CSV file. The CSV should have columns: `name` and `id_token`. Maximum file size is 1 MB.

<ParamField path="site" type="string" required>
  The UUID of the location.
</ParamField>

<ParamField body="file" type="file" required>
  A CSV file containing card data. Accepted formats: `.csv`, `.txt`. Maximum size: 1 MB.
</ParamField>

## Response

<ResponseField name="message" type="string">
  A status message indicating the import result.
</ResponseField>

<ResponseField name="created" type="integer">
  The number of cards successfully created.
</ResponseField>

<ResponseField name="skipped" type="integer">
  The number of cards skipped (e.g., duplicates).
</ResponseField>

<ResponseField name="errors" type="array">
  An array of error objects for rows that failed to import.

  <Expandable title="error object">
    <ResponseField name="row" type="integer">
      The row number in the CSV file.
    </ResponseField>

    <ResponseField name="name" type="string">
      The card name from the CSV row.
    </ResponseField>

    <ResponseField name="id_token" type="string">
      The ID token from the CSV row.
    </ResponseField>

    <ResponseField name="error" type="string">
      A description of the validation error.
    </ResponseField>
  </Expandable>
</ResponseField>