---
title: "Autocomplete Products"
method: GET
path: "/locations/{location_id}/products/autocomplete"
tags: ["Products"]
---

# Autocomplete Products

`GET /locations/{location_id}/products/autocomplete`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{location_id}/products/autocomplete`
- Auth: HTTP bearer

Search Products by name, article number, or barcode.

The search term must contain at least two characters and cannot contain
emoji. Pagination uses `page` and `limit` and is returned in
`meta.pagination`.

## Path parameters

- `location_id` integer, required

## Query parameters

- `filter[term]` string, required
- `page` integer
- `limit` integer
- `include` string[]

## Headers

- `Accept` string, required
- `Authorization` string, required

## Response `200`

Products retrieved successfully

- object
  - `data` ProductResource[], required
    - `type` 'good', required: Literal JSON:API resource type
    - `id` string, required: Product ID
    - `attributes` object, required
      - `category_id` integer, required: Product Category ID
      - `title` string, required: Product name
      - `sale_unit_id` integer, required: Sale Unit ID
      - `consumable_unit_id` integer, required: Consumable Unit ID
      - `sale_unit_to_consumable_unit_ratio` number, required: Number of Consumable Units in one Sale Unit
      - `loyalty_abonement_type_id` integer, nullable, required: Membership type ID, when the Product represents a membership
      - `loyalty_certificate_type_id` integer, nullable, required: Certificate type ID, when the Product represents a certificate
      - `cost` number, required: Product sale price
      - `actual_cost` number, nullable, required: Current Product cost when `actual_cost` is requested and the Business User has permission to view it; otherwise `null`.
      - `is_chain` boolean, required: Whether the Product belongs to the Chain catalog
    - `relationships` object: Present when related data is requested through `include`
      - `loyalty_abonement_type` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `loyalty_certificate_type` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `mark_settings` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `storage_amounts` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
  - `included` IncludedResource[]: Resources requested through `include`, when available
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
    - `relationships` object
  - `meta` object, required
    - `pagination` Pagination, required
      - `page` integer, required
      - `offset` integer, required
      - `limit` integer, required

## Other responses

- `400`: Search term contains emoji
- `401`: Unauthorized
- `403`: Forbidden - No permission to search Products for this Location
- `404`: Location not found
- `422`: Invalid search term, pagination, or include value

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
