---
title: "Add a batch of entries to a hotlist"
method: POST
path: "/hotlists/{hotlistId}/entries/addBatch"
tags: ["Custom Hotlists"]
---

# Add a batch of entries to a hotlist

`POST /hotlists/{hotlistId}/entries/addBatch`

Add a batch of entries to the hotlist with the provided hotlistID. All entries will be normalized (O->0) and have whitespace trimmed. Duplicate entries will be ignored.

## Path parameters

- `hotlistId` string, uuid, required

## Request body

- CreateHotlistEntriesRequest
  - `entries` CreateHotlistEntryRequest[], required
    - `caseNumber` string, required
    - `expiry` string, date-time — ISO datetime string. After this date, alerts will not be triggered for this entry.
    - `plate` string, required
    - `reason` string, required
    - `state` 'alabama' | 'alaska' | 'arizona' | 'arkansas' | 'california' | 'colorado' | 'connecticut' | 'delaware' | 'washington_dc' | 'florida' | 'georgia' | 'hawaii' | 'idaho' | 'illinois' | 'indiana' | 'iowa' | 'kansas' | 'kentucky' | 'louisiana' | 'maine' | 'maryland' | 'massachusetts' | 'michigan' | 'minnesota' | 'mississippi' | 'missouri' | 'montana' | 'nebraska' | 'nevada' | 'new_hampshire' | 'new_jersey' | 'new_mexico' | 'new_york' | 'north_carolina' | 'north_dakota' | 'ohio' | 'oklahoma' | 'oregon' | 'pennsylvania' | 'rhode_island' | 'south_carolina' | 'south_dakota' | 'tennessee' | 'texas' | 'utah' | 'vermont' | 'virginia' | 'washington' | 'west_virginia' | 'wisconsin' | 'wyoming' | 'puerto_rico'
    - `note` HotlistEntryNote — Optional note with message field for the hotlist entry
      - `message` string, required — Note message text (supports URLs for clickable links in UI)

## Response `200`

The batch of hotlist entries was successfully normalized and created.

- CreateEntriesResponse
  - `entries` HotlistEntry[], required
    - `id` string
    - `caseNumber` string, required
    - `expiry` string, date-time — ISO datetime string
    - `plate` string, required
    - `reason` string, required
    - `state` 'alabama' | 'alaska' | 'arizona' | 'arkansas' | 'california' | 'colorado' | 'connecticut' | 'delaware' | 'washington_dc' | 'florida' | 'georgia' | 'hawaii' | 'idaho' | 'illinois' | 'indiana' | 'iowa' | 'kansas' | 'kentucky' | 'louisiana' | 'maine' | 'maryland' | 'massachusetts' | 'michigan' | 'minnesota' | 'mississippi' | 'missouri' | 'montana' | 'nebraska' | 'nevada' | 'new_hampshire' | 'new_jersey' | 'new_mexico' | 'new_york' | 'north_carolina' | 'north_dakota' | 'ohio' | 'oklahoma' | 'oregon' | 'pennsylvania' | 'rhode_island' | 'south_carolina' | 'south_dakota' | 'tennessee' | 'texas' | 'utah' | 'vermont' | 'virginia' | 'washington' | 'west_virginia' | 'wisconsin' | 'wyoming' | 'puerto_rico'
    - `note` HotlistEntryNote — Optional note with message field for the hotlist entry
      - `message` string, required — Note message text (supports URLs for clickable links in UI)

## Other responses

- `400` — Bad request, either the batch contained a duplicate plate or the request body was malformed.
- `401` — Unauthorized, authentication token was invalid or not provided
- `403` — Forbidden, your client does not have access to this resource
- `404` — No hotlist was found with the given ID

---

[API](https://skmtc.net/flocksafety/apis/oauth-api.md) · [All operations](https://skmtc.net/flocksafety/apis/oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flocksafety/oauth-api/versions/126df7964ba5/schema)