> ## Documentation Index
> Fetch the complete documentation index at: https://redo-44af351d-docs-v3-graphql-api-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# location
> Fetch a single location by its id.
**Required scopes:**
[`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
## Arguments
The id of the location to fetch.
## Returns
Location}>
A physical or logical location where inventory is held or shipped from.
The city of the location's address.
The company name associated with the location.
The country code, e.g. "US".
DateTime!} required>
When the record was created.
The id of this location.
LocationInventoryLevelConnection!} required>
Per-product inventory levels held at this location.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
**Fields**
[LocationInventoryLevelEdge!]!} required>
The list of edges (each a node plus its pagination `cursor`).
Opaque cursor for this item; pass to `after`/`before` to page from here.
LocationInventoryLevel!} required>
The item at this edge.
[LocationInventoryLevel!]!} required>
The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.
The quantity available to sell.
The quantity that can be built from components.
The quantity committed to existing orders.
DateTime!} required>
When the record was created.
The id of this inventory level.
InventoryProduct}>
A fulfillment-oriented view of the product, readable by anyone who can see this level (e.g. a 3PL). For the full product, use `product`.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
Location}>
The location these inventory levels are held at.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
Product}>
The full product these inventory levels are for. Only readable by the account that owns the product; use `inventoryProduct` otherwise.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
The total quantity on hand at the location.
The quantity reserved across all reservation buckets.
DateTime!} required>
When the record was last updated.
PageInfo!} required>
Pagination metadata for the current page.
Cursor of the last edge in this page; pass to `after` to page forward.
Whether more items exist after this page (drives forward pagination with `first`/`after`).
Whether more items exist before this page (drives backward pagination with `last`/`before`).
Cursor of the first edge in this page; pass to `before` to page backward.
The location's display name.
The contact phone number for the location.
The postal or ZIP code, e.g. "84101".
The state or province code, e.g. "UT".
The first line of the street address.
The second line of the street address.
DateTime!} required>
When the record was last updated.
## Example
```graphql theme={null}
query {
location(id: "...") {
city
company
countryCode
createdAt
id
inventoryLevels {
nodes {
available
buildable
committed
createdAt
id
quantity
reserved
updatedAt
}
pageInfo {
hasNextPage
endCursor
}
}
name
phone
# ...
}
}
```