---
title: "Retrieve all Allocations"
method: GET
path: "/v2/org/{org}/nico/allocation"
tags: ["Allocation"]
---

# Retrieve all Allocations

`GET /v2/org/{org}/nico/allocation`

Retrieve all Allocations for the org.

Provider and Tenant roles are inferred from the org's membership. User must have authorization role with `PROVIDER_ADMIN` or `TENANT_ADMIN` suffix.

Results are returned from both Provider and Tenant perspectives when the org has both roles.

## Query parameters

- `infrastructureProviderId` string, uuid
- `tenantId` string, uuid
- `siteId` string, uuid
- `id` string
- `resourceType` 'InstanceType' | 'IPBlock'
- `status` string
- `resourceTypeId` string
- `constraintType` 'Reserved' | 'OnDemand' | 'Preemptible'
- `constraintValue` integer
- `query` string
- `includeRelation` 'InfrastructureProvider' | 'Tenant' | 'Site'
- `pageNumber` integer
- `pageSize` integer
- `orderBy` 'NAME_ASC' | 'NAME_DESC' | 'STATUS_ASC' | 'STATUS_DESC' | 'CREATED_ASC' | 'CREATED_DESC' | 'UPDATED_ASC' | 'UPDATED_DESC' | 'SITE_NAME_ASC' | 'SITE_NAME_DESC' | 'TENANT_ORG_DISPLAY_NAME_ASC' | 'TENANT_ORG_DISPLAY_NAME_DESC' | 'INSTANCE_TYPE_NAME_ASC' | 'INSTANCE_TYPE_NAME_DESC' | 'IP_BLOCK_NAME_ASC' | 'IP_BLOCK_NAME_DESC' | 'CONSTRAINT_VALUE_ASC' | 'CONSTRAINT_VALUE_DESC'

## Response `200`

OK

- Allocation[]
  - `id` string, uuid — ID of the Allocation
  - `name` string — Concise and descriptive name of the Allocation
  - `description` string, nullable — Detailed description of the Allocation
  - `infrastructureProviderId` string, uuid — ID of the Infrastructure Provider that created the Allocation
  - `tenantId` string, uuid — ID of the Tenant that received the Allocation
  - `siteId` string, uuid — ID of the Site where resources are allocated
  - `status` 'Pending' | 'Registered' | 'Deleting' | 'Error' — Status values for Allocation objects
  - `statusHistory` StatusDetail[]
    - `status` string
    - `message` string, nullable
    - `created` string, date-time
    - `updated` string, date-time
  - `allocationConstraints` AllocationConstraint[]
    - `id` string, uuid — ID of the Allocation Constraint
    - `allocationId` string, uuid — ID of the Allocation that contains the Allocation Constraint
    - `resourceType` 'InstanceType' | 'IPBlock' — Type of the Resource that the Allocation Constraint applies to
    - `resourceTypeId` string, uuid — ID of the Resource Type that acts as the source of the Allocation. For resource type: `InstanceType`, this is the ID of the Instance Type whose associated Machines are allocated to the Tenant. For resource type `IPBlock`, this is the ID of the Site level IP Block from where a prefix is allocated to the Tenant.
    - `constraintType` 'Reserved' | 'OnDemand' | 'Preemptible' — Type of the Allocation Constraint. `Reserved` is the only constraint type supported by current implementation.
    - `constraintValue` integer — Value of the Allocation Constraint. For resource type: `InstanceType`, this value represents number of Machines associated with the Instance Type that is allocated to the Tenant. For resource type `IPBlock`, this value represents the prefix length of the IP Block allocated to the Tenant.
    - `derivedResourceId` string, nullable — ID of the allocated Tenant IP Block when resource type is IPBlock
    - `instanceType` InstanceTypeSummary — Describes a subset of core attributes of an Instance Type
      - `id` string, uuid
      - `name` string
      - `infrastructureProviderId` string, uuid
      - `siteId` string, uuid
      - `status` 'Pending' | 'Registering' | 'Ready' | 'Deleting' | 'Error' — Status values for Instance Type objects
    - `ipBlock` IpBlockSummary — Describes a subset of core attributes of an IP block
      - `id` string, uuid
      - `name` string
      - `routingType` 'Public' | 'DatacenterOnly'
      - `prefix` string — Either IPv4 or IPv6 address
      - `prefixLength` integer — Min: 1, Max: 32 for ipv4, 128 for ipv6
      - `status` 'Pending' | 'Provisioning' | 'Ready' | 'Deleting' | 'Error' — Status values for IP Block objects
    - `created` string, date-time — Date/time when the Allocation Constraint was created
    - `updated` string, date-time — Date/time when the Allocation Constraint was last updated
  - `created` string, date-time — Date/time when the Allocation was created
  - `updated` string, date-time — Date/time when the Allocation was last updated

## Other responses

- `403` — Error response when user is not authorized to call an endpoint or retrieve/modify objects

---

[API](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-infra-controller-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-infra-controller-rest-api/revisions/c8ea33c2b23f/schema)