---
title: "POST /api/v1/gapc-properties.search"
method: POST
path: "/api/v1/gapc-properties.search"
tags: ["Lookup"]
---

# POST /api/v1/gapc-properties.search

`POST /api/v1/gapc-properties.search`

## Request

- Base URL: `https://api.partly.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.partly.com/api/v1/gapc-properties.search`
- Auth: none declared. Required headers: `authorization`

Search the whole GAPC catalogue's brands and part types by name or alias, best match first. Returns the same entities as `gapc-properties.lookup`.

## Headers

- `authorization` string, required: UTF-8 encoded string

## Request body

- LookupGapcPropertiesSearchRequest
  - `brands` LookupGapcPropertiesSearchQuery
    - `query` string, required: UTF-8 encoded string
  - `languages` StdStringString[]: The languages to return names in. If empty, every translation is returned. Matching always considers every name, translation and alias.
  - `limit` integer: 32-bit unsigned integer
  - `part_types` LookupGapcPropertiesSearchQuery
    - `query` string, required: UTF-8 encoded string

## Response `200`

200 OK

- LookupGapcPropertiesSearchResponse
  - `brands` LookupGapcBrand[], required: Matching brands, best first. Empty when `brands` was not requested.
    - `aliases` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `created_at` string, date-time, required: DateTime at a given timezone (RFC3339 format)
    - `descriptions` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `id` string, required: UTF-8 encoded string
    - `is_manufacturer` boolean: Boolean value
    - `is_oem` boolean, required: Boolean value
    - `is_oes` boolean: Boolean value
    - `is_whitelabel` boolean: Boolean value
    - `logo_url` string: UTF-8 encoded string
    - `names` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `updated_at` string, date-time, required: DateTime at a given timezone (RFC3339 format)
  - `part_types` LookupGapcPartType[], required: Matching part types, best first, as `gapc-properties.lookup` returns them without the `part_codes` include. Empty when `part_types` was not requested.
    - `aliases` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `assembly_classification` union
      - 'assembly'
      - 'assortments'
      - 'fastener'
      - 'hardware_kit'
      - 'installation_kit'
      - 'kit'
      - 'length'
      - 'module'
      - 'other'
      - 'set'
      - 'unit'
    - `categorizations` LookupGapcPartTypeCategorization[], required: Expandable array type
      - `category_id` string, required: UTF-8 encoded string
      - `subcategory_id` string, required: UTF-8 encoded string
    - `created_at` string, date-time, required: DateTime at a given timezone (RFC3339 format)
    - `department` union
      - 'accessories'
      - 'fluids'
      - 'other'
      - 'replacement_parts'
      - 'tool'
      - 'wheels'
    - `descriptions` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `id` string, required: UTF-8 encoded string
    - `is_multi_purpose` boolean: Boolean value
    - `names` LanguageString[], required: Expandable array type
      - `language` string, required: UTF-8 encoded string
      - `value` string, required: UTF-8 encoded string
    - `position_classification` union
      - 'general_required'
      - 'not_required'
      - 'vehicle_based'
    - `positions` StdStringString[], required: Expandable array type
    - `primary_fitment_classification` union
      - 'attribute_based'
      - 'not_required'
      - 'universal'
      - 'vehicle_based'
    - `recommended_attributes` StdStringString[], required: Attributes which are recommended to be defined on a part of this type
    - `secondary_fitment_classification` union
      - 'attribute_based'
      - 'not_required'
      - 'universal'
      - 'vehicle_based'
    - `updated_at` string, date-time, required: DateTime at a given timezone (RFC3339 format)
    - `uvdb_property_id_prefixes` StdStringString[], nullable: Expandable array type

## Other responses

- `default`: Error cases

## Changes

- **2026-10-16** `3e86fbe429fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/partly/apis/core-server/changes/api/v1/gapc-properties.search/post.md)

---

[API](https://skmtc.dev/partly/apis/core-server.md) · [All operations](https://skmtc.dev/partly/apis/core-server/llms.txt) · [OpenAPI document](https://skmtc.dev/partly/apis/core-server/revisions/19dd5c84162b?raw)