# Preview receipt numbering `GET /api/v1/payments/receipt-numbering/preview` Previews the next receipt number for a document date. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Payments → Read**. ## Query parameters - `date` (date string) — Document date in YYYY-MM-DD format. Defaults to today. - `series_id` (integer) — Use a compatible receipt series. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --get \ --url "https://api.asdincloud.com/api/v1/payments/receipt-numbering/preview" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --data-urlencode "date=2026-11-14" ``` ## Response **200 OK** Returns the proposed number, series, and whether the numbering setup is confirmed. The preview does not reserve the number. Example with fictional data and selected fields. ```json { "data": { "document_date": "2026-11-14", "series_id": 4, "series_code": "2026", "next_number": 15, "display_number": "15", "next_reset_on": "2027-01-01", "indicative": true, "confirmed": true, "version": 1, "compatible_series": [ { "id": 4, "code": "2026" } ] } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `400` — The supplied fields or payment state do not allow this action.