> ## Documentation Index > Fetch the complete documentation index at: https://help.gorelo.io/llms.txt > Use this file to discover all available pages before exploring further. # A single catalog item — a product or a bundle. > Adds `SubItems` over the list shape: the bundle's component products, each with the quantity and the cost/price it carried when added. Present only for a bundle; null for a product. A non-existent id, or one belonging to another service provider, is a 404. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/items/{itemId} openapi: 3.0.4 info: title: Public API description: Gorelo Public API documentation. version: 1.0.0 servers: - url: https://api.usw.gorelo.io description: US - url: https://api.aue.gorelo.io description: Australia security: - ApiKeyAuth: [] tags: - name: Attachments description: "Uploading a file, for anything that can carry one. One endpoint rather than one per record\r\ntype, because the upload itself is identical - only the record it is checked against differs." - name: Alerts description: Alerts management operations - name: Assets description: Assets management operations - name: Billing description: Billing management operations - name: Tickets description: Tickets management operations - name: Clients description: Clients management operations - name: Contacts description: Contacts management operations - name: Deletions description: Deletions management operations - name: Documents description: Documents management operations - name: Forms description: Forms management operations - name: Organization description: Organization management operations - name: Projects description: Projects management operations paths: /v1/items/{itemId}: get: tags: - Billing summary: A single catalog item — a product or a bundle. description: "Adds `SubItems` over the list shape: the bundle's component products, each with the\r\nquantity and the cost/price it carried when added. Present only for a bundle; null for a\r\nproduct. A non-existent id, or one belonging to another service provider, is a 404." operationId: get_v1_items_itemId parameters: - name: itemId in: path description: Identifier of the item. required: true schema: type: string format: uuid responses: '200': description: OK content: text/plain: schema: $ref: '#/components/schemas/ItemDetailModelBaseResponse' application/json: schema: $ref: '#/components/schemas/ItemDetailModelBaseResponse' text/json: schema: $ref: '#/components/schemas/ItemDetailModelBaseResponse' '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/ObjectBaseResponse' application/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' text/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' '404': description: Not Found content: text/plain: schema: $ref: '#/components/schemas/ObjectBaseResponse' application/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' text/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' '500': description: Internal Server Error content: text/plain: schema: $ref: '#/components/schemas/ObjectBaseResponse' application/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' text/json: schema: $ref: '#/components/schemas/ObjectBaseResponse' components: schemas: ItemDetailModelBaseResponse: type: object properties: StatusCode: $ref: '#/components/schemas/HttpStatusCode' IsSuccess: type: boolean Data: $ref: '#/components/schemas/ItemDetailModel' DataContext: type: object additionalProperties: false nullable: true example: null Notifications: type: array items: $ref: '#/components/schemas/Error' additionalProperties: false ObjectBaseResponse: type: object properties: StatusCode: $ref: '#/components/schemas/HttpStatusCode' IsSuccess: type: boolean Data: nullable: true DataContext: $ref: '#/components/schemas/ErrorDataContext' Notifications: type: array items: $ref: '#/components/schemas/Error' additionalProperties: false HttpStatusCode: enum: - 100 - 101 - 102 - 103 - 200 - 201 - 202 - 203 - 204 - 205 - 206 - 207 - 208 - 226 - 300 - 301 - 302 - 303 - 304 - 305 - 306 - 307 - 308 - 400 - 401 - 402 - 403 - 404 - 405 - 406 - 407 - 408 - 409 - 410 - 411 - 412 - 413 - 414 - 415 - 416 - 417 - 421 - 422 - 423 - 424 - 426 - 428 - 429 - 431 - 451 - 500 - 501 - 502 - 503 - 504 - 505 - 506 - 507 - 508 - 510 - 511 type: integer format: int32 ItemDetailModel: type: object properties: Id: type: string description: Identifier of the item. format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 Type: $ref: '#/components/schemas/CodeModel' Status: $ref: '#/components/schemas/CodeModel' Name: type: string description: Display name of the item. example: Managed Workstation - Standard Number: type: string description: The item's product number, free text. Not clearable once set. nullable: true Description: type: string description: Free-text description. nullable: true CategoryId: type: integer description: >- Category the item is filed under, resolvable against GET /v1/items/categories. format: int64 nullable: true SubcategoryId: type: integer description: Subcategory the item is filed under, nested under CategoryId. format: int64 nullable: true ClientId: type: integer description: >- Client this item is scoped to, when it is client-specific rather than catalog-wide. format: int64 nullable: true LocationId: type: integer description: >- Client location this item is scoped to. Only meaningful alongside ClientId. format: int64 nullable: true Sku: type: string description: Stock-keeping unit. Product-only; null for a bundle. nullable: true PartNumber: type: string description: Manufacturer part number. Product-only; null for a bundle. nullable: true Manufacturer: type: string description: Manufacturer name. Product-only; null for a bundle. nullable: true Vendor: type: string description: Vendor the item is sourced from. nullable: true UnitCost: type: number description: "Unit cost. For a product this is its current cost. For a bundle this is the sum of its\r\nsub-items' unit cost times quantity." format: double nullable: true example: 42.5 UnitPrice: type: number description: Unit price charged to the client. format: double nullable: true example: 89 TaxId: type: integer description: "Tax rate applied to this item, resolvable against GET /v1/taxes, or null when none is\r\nassigned." format: int64 nullable: true ExternalProductId: type: string description: >- Identifier of this item in an external accounting system (QuickBooks/Xero), or null. nullable: true CreatedOn: type: string description: When the item was created, in UTC. format: date-time nullable: true UpdatedOn: type: string description: >- When the item was last changed, in UTC. Null when it has never been changed. format: date-time nullable: true SubItems: type: array items: $ref: '#/components/schemas/ItemSubItemModel' description: "The products that make up this bundle, each with its quantity and the cost/price it\r\ncarried at the time it was added to the bundle. Present (and possibly empty) only for a\r\nbundle; null for a product." nullable: true ShowSubItemsOnInvoice: type: boolean description: >- Bundle-only: whether the bundle's sub-items are listed individually on an invoice. nullable: true ShowSubItemDescriptionsOnInvoice: type: boolean description: >- Bundle-only: whether each sub-item's description is shown alongside it on an invoice. nullable: true additionalProperties: false description: "A single item. Returns every field the item list returns, with the same values, plus the\r\nsub-item breakdown for a bundle." Error: type: object properties: Code: pattern: ^[0-9]{6}$ type: string description: 6-digit MMTTNN error code. See the Public API error-code registry. example: '070101' Message: type: string PropertyName: type: string nullable: true ActionHint: type: string nullable: true DocUrl: type: string nullable: true additionalProperties: false ErrorDataContext: type: object properties: TraceId: type: string description: Request correlation id. Quote this when reporting a problem. nullable: true additionalProperties: false description: "The `DataContext` of an error response: carries the correlation id for the failed\r\nrequest." CodeModel: type: object properties: Id: type: integer description: >- Numeric identifier of the coded value (e.g. status, priority, type, or source id). format: int64 example: 1 Name: type: string description: Display name of the coded value. additionalProperties: false description: >- A coded value, such as a status, priority, type or source, as an id and a display name. ItemSubItemModel: type: object properties: ItemId: type: string description: Identifier of the product this sub-item refers to. format: uuid Name: type: string description: Name of the referenced product, echoed for convenience. Quantity: type: number description: How many of this product the bundle includes. format: double example: 2 UnitCost: type: number description: >- Unit cost recorded against this sub-item at the time it was added to the bundle. format: double nullable: true UnitPrice: type: number description: >- Unit price recorded against this sub-item at the time it was added to the bundle. format: double nullable: true additionalProperties: false description: One product inside a bundle. securitySchemes: ApiKeyAuth: type: apiKey description: >- Your Gorelo API key. See [Generate API key](/generate-api-key). If your data is hosted in Australia, click the base URL at the top of this page and select `https://api.aue.gorelo.io`. name: X-API-Key in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.