# Read an allocation

Returns one allocation of an item to a person: when it was given, when it was
collected, when it expires, and which serial was assigned if the item carries
them.

The person and the item are embedded in the response by default rather than
having to be asked for. The person is returned as their full profile, so treat
this response as carrying personal data even when all you wanted was the
allocation.

An allocation with no collection time has not been handed over yet.

The allocation must belong to the item in the URL; a mismatched pair returns a
404.

Endpoint: GET /api/v2/inventory/item/{item_id}/user/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `item_id` (integer, required)
    The ID of the inventory item.

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

## Header parameters:

  - `Rosterfy-Platform` (string)

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.inventory_allocation_id` (string | null)

  - `object.inventory_item_id` (integer)

  - `object.user_id` (integer)

  - `object.entity` (string | null)

  - `object.entity_id` (string | null)

  - `object.inventory_allocation_type` (string)

  - `object.serial` (string | null)

  - `object.inventory_item_serial_id` (string | null)

  - `object.expires_at` (string)

  - `object.collected_at` (string)

  - `object.collected_entity` (string | null)

  - `object.collected_by` (string | null)

  - `object.data` (string | null)

  - `object.sort_order` (integer)

  - `object.deleted_at` (string | null)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `nice` (object)

  - `nice.inventory_allocation_type` (string)

  - `nice.user_name` (string)

  - `relations` (object)

  - `relations.user` (object)

  - `relations.user.object` (object)

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

  - `relations.user.object.first_name` (string)

  - `relations.user.object.last_name` (string)

  - `relations.user.object.email` (string)

  - `relations.user.nice` (object)

  - `relations.user.nice.first_name` (string)

  - `relations.user.nice.last_name` (string)

  - `relations.user.permissions` (object)

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

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

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

  - `relations.user.id` (integer)

  - `relations.user.name` (string)

  - `relations.inventory_allocation` (string | null)

  - `relations.inventory_item` (object)

  - `relations.inventory_item.object` (object)

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

  - `relations.inventory_item.object.parent_id` (string | null)

  - `relations.inventory_item.object.type` (string)

  - `relations.inventory_item.object.external_id` (string)

  - `relations.inventory_item.object.certificate_id` (string | null)

  - `relations.inventory_item.object.is_image` (integer)

  - `relations.inventory_item.object.icon` (string)

  - `relations.inventory_item.object.variation_config` (string | null)

  - `relations.inventory_item.object.has_quantity` (integer)

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

  - `relations.inventory_item.object.max_per_user` (integer)

  - `relations.inventory_item.object.has_serial` (integer)

  - `relations.inventory_item.object.category_id` (string | null)

  - `relations.inventory_item.object.serial_assignment_mode` (string | null)

  - `relations.inventory_item.object.is_distributable` (integer)

  - `relations.inventory_item.object.is_redeemable` (integer)

  - `relations.inventory_item.object.ttl` (string | null)

  - `relations.inventory_item.object.reward_point_cost` (integer)

  - `relations.inventory_item.object.budget_cost` (string)

  - `relations.inventory_item.object.publish` (integer)

  - `relations.inventory_item.object.sort_order` (integer)

  - `relations.inventory_item.object.has_variants` (integer)

  - `relations.inventory_item.object.varied_by_attribute_id` (string | null)

  - `relations.inventory_item.object.variant_source_id` (string | null)

  - `relations.inventory_item.object.is_archived` (integer)

  - `relations.inventory_item.object.is_distributable_at_checkin_checkout` (string | null)

  - `relations.inventory_item.object.deleted_at` (string | null)

  - `relations.inventory_item.object.is_erased` (integer)

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

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

  - `relations.inventory_item.object.deleted_by` (string | null)

  - `relations.inventory_item.object.is_inheritable` (integer)

  - `relations.inventory_item.object.name` (string)

  - `relations.inventory_item.nice` (object)

  - `relations.inventory_item.nice.created_at` (string)

  - `relations.inventory_item.nice.created_at__date` (string)

  - `relations.inventory_item.nice.created_at__time` (string)

  - `relations.inventory_item.nice.created_at__offset` (string)

  - `relations.inventory_item.nice.created_at__offset_minutes` (integer)

  - `relations.inventory_item.nice.created_at__dayofweek` (string)

  - `relations.inventory_item.nice.external_id` (string)

  - `relations.inventory_item.nice.has_quantity` (string)

  - `relations.inventory_item.nice.has_variants` (string)

  - `relations.inventory_item.nice.is_distributable_at_checkin_checkout` (string)

  - `relations.inventory_item.nice.name` (string)

  - `relations.inventory_item.nice.publish` (string)

  - `relations.inventory_item.nice.type` (string)

  - `relations.inventory_item.nice.type:value` (string)

  - `relations.inventory_item.nice.type:array` (string)

  - `relations.inventory_item.nice.updated_at` (string)

  - `relations.inventory_item.nice.updated_at__date` (string)

  - `relations.inventory_item.nice.updated_at__time` (string)

  - `relations.inventory_item.nice.updated_at__offset` (string)

  - `relations.inventory_item.nice.updated_at__offset_minutes` (integer)

  - `relations.inventory_item.nice.updated_at__dayofweek` (string)

  - `relations.inventory_item.nice.distributed` (integer)

  - `relations.inventory_item.nice.allocated` (integer)

  - `relations.inventory_item.nice.available` (integer)

  - `relations.inventory_item.nice.stock_level` (string)

  - `relations.inventory_item.nice.manual_serial_required` (boolean)

  - `relations.inventory_item.nice.account_name_path` (string)

  - `relations.inventory_item.nice.is_foreign_account` (boolean)

  - `relations.inventory_item.permissions` (object)

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

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

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

  - `relations.serial_obj` (string | null)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)

  - `permissions.user_update` (boolean)