# Read an allocation rule

Returns one rule with its qualifying condition and the items it hands out.
`relations.items` carries the item list in full, so a separate call is not
needed to see what the rule gives away. `nice` restates the qualifying condition
in readable form - `rule_name` is the measure and `rule_value` the threshold.

Endpoint: GET /api/v2/inventory/allocation/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `id` (integer, required)
    The ID of the allocation rule.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.type` (string)

  - `object.name` (string)

  - `object.rules` (array)

  - `object.rules.type` (string)

  - `object.rules.value` (integer)

  - `object.conditions` (array)

  - `object.deleted_at` (string | null)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `nice` (object)

  - `nice.rule_name` (string)

  - `nice.rule_value` (integer)

  - `relations` (object)

  - `relations.items` (array)

  - `relations.items.object` (object)

  - `relations.items.object.id` (integer)

  - `relations.items.object.inventory_item_id` (integer)

  - `relations.items.object.quantity` (integer)

  - `relations.items.object.valid_duration` (integer)

  - `relations.items.object.created_at` (string)

  - `relations.items.object.updated_at` (string)

  - `relations.items.nice` (array)

  - `relations.items.permissions` (object)

  - `relations.items.permissions.read` (boolean)

  - `relations.items.permissions.update` (boolean)

  - `relations.items.permissions.delete` (boolean)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)