# Allocate one or a batch of zimarker codes

Allocates the next unassigned zimarker code(s) for the calling organization. quantity defaults to 1 when omitted; quantity greater than 1 allocates a batch, reserved atomically as a single block (all-or-nothing). quantity is capped at a configurable maximum batch size. Returns an ordered list of allocated entries, each with the marker code and its marker image. imageDelivery selects the image form: BASE64 (default) returns a 1-bit, 600x600 black-and-white PNG inline as base64 in markerImage; URL returns the marker's public image URL in markerImageUrl instead of inline bytes.

Endpoint: POST /integration/rest/api/v1/zmarker-code/allocate
Version: v0
Security: X-AUTH-KEY

## Query parameters:

  - `quantity` (integer)
    Number of codes to allocate. Defaults to 1 when omitted.
    Example: 1

  - `imageDelivery` (string)
    Marker image delivery form: BASE64 (default) returns the image inline as base64 in markerImage; URL returns the public image URL in markerImageUrl.
    Enum: "BASE64", "URL"

## Response 200 fields (*/*):

  - `markerCode` (string)
    The allocated zimarker code.
    Example: 123456

  - `markerImage` (string)
    The marker rendered as a 1-bit, 600x600 black-and-white PNG, base64-encoded (inline). Present only when imageDelivery is BASE64 (the default).

  - `markerImageUrl` (string)
    The marker image's public, stable URL ({base-path}/{markerCode}.png). Present only when imageDelivery is URL.
    Example: "https://acme.zimark.link/integration/rest/api/v1/zmarker-code/image/123456.png"

## Response 400 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 403 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 500 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id