Piloterr Lenovo API

The Lenovo API from Piloterr — 2 operation(s) for lenovo.

GitHub OpenAPI

Operations 4

GET /v2/lenovo/product Lenovo Product #
POST /v2/lenovo/product Lenovo Product #
POST /v2/lenovo/search Lenovo Search #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/piloterr-com:piloterr-com-lenovo-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

piloterr-com-lenovo-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Piloterr API Reference Lenovo API
  description: Complete API reference documentation.
  version: 1.0.0
servers:
- url: https://api.piloterr.com
  description: API Server
tags:
- name: Lenovo
paths:
  /v2/lenovo/product:
    get:
      summary: Lenovo Product
      description: 'Extract a Lenovo product page by URL: id, name, price, currency, availability, images, and description (browser rendering, 2 credits).


        **Credit cost:** 2 credits per call'
      operationId: get-lenovo-product
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Full Lenovo product URL (must contain `/p/`). Bare part numbers are rejected.


          **Examples:**


          ```

          https://www.lenovo.com/fr/fr/p/workstations/thinkstationp/thinkstation-p5-gen-2-intel-tower-workstation/len102s0024

          ```


          ```

          https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus

          ```'
        schema:
          type: string
          description: 'Full Lenovo product URL (must contain `/p/`). Bare part numbers are rejected.


            **Examples:**


            ```

            https://www.lenovo.com/fr/fr/p/workstations/thinkstationp/thinkstation-p5-gen-2-intel-tower-workstation/len102s0024

            ```


            ```

            https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus

            ```'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  mpn:
                    type: string
                  sku:
                    type: string
                  url:
                    type: string
                  name:
                    type: string
                  brand:
                    type: string
                  price:
                    type: number
                  title:
                    type: string
                  images:
                    type: array
                    items:
                      type: string
                  series:
                    type: string
                  category:
                    type: string
                  currency:
                    type: string
                  product_id:
                    type: string
                  config_type:
                    type: string
                  description:
                    type: string
                  availability:
                    type: string
                  thumbnail_url:
                    type: string
              examples:
                ThinkStation P5 Gen 2 (France):
                  value:
                    mpn: LEN102S0024
                    sku: LEN102S0024
                    url: https://www.lenovo.com/fr/fr/p/workstations/thinkstationp/thinkstation-p5-gen-2-intel-tower-workstation/len102s0024
                    name: ThinkStation P5 Gen 2 (Intel) Tower
                    brand: Série P
                    price: 4439.02
                    title: ThinkStation P5 Gen 2 (Intel) Tower
                    images:
                    - https://p4-ofp.static.pub/ShareResource/optimized/thinkstation/thinkstation-p5-gen2-intel-tower/lenovo-thinkstation-p5-gen-2-pdp-hero.png
                    series: ThinkStation
                    category: Workstations
                    currency: EUR
                    product_id: LEN102S0024
                    config_type: CTO
                    description: La station de travail tour Lenovo ThinkStation P5 Gen 2 (Intel) offre des performances prêtes pour l’IA, un processeur avancé et une carte graphique professionnelle pour les tâches critiques.
                    availability: in_stock
                    thumbnail_url: https://p4-ofp.static.pub/ShareResource/optimized/thinkstation/thinkstation-p5-gen2-intel-tower/lenovo-thinkstation-p5-gen-2-pdp-hero.png
                ThinkPad E16 Gen 3 (United States):
                  value:
                    mpn: LEN101T0125
                    sku: 21TF001NUS
                    url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus
                    name: ThinkPad E16 Gen 3 (16″ Intel) Laptop
                    brand: ThinkPad
                    price: 1599
                    title: ThinkPad E16 Gen 3 (16″ Intel) Laptop
                    images:
                    - https://p4-ofp.static.pub//fes/cms/2025/04/07/52kiu4uukvy6dnj3ryrs2grmwt7716558555.png
                    series: ThinkPad
                    category: Laptops
                    currency: USD
                    product_id: 21TF001NUS
                    config_type: MTM
                    description: The 16″ Lenovo ThinkPad E16 Gen 3 laptop with Intel® Core™ processors boasts enhanced performance & long battery life for anywhere business.
                    availability: in_stock
                    thumbnail_url: https://p4-ofp.static.pub//fes/cms/2025/04/07/52kiu4uukvy6dnj3ryrs2grmwt7716558555.png
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Lenovo
    post:
      summary: Lenovo Product
      description: 'Extract a Lenovo product page by URL: id, name, price, currency, availability, images, and description (browser rendering, 2 credits).


        **Credit cost:** 2 credits per call'
      operationId: post-lenovo-product
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Full Lenovo product URL (must contain `/p/`). Bare part numbers are rejected.


                    **Examples:**


                    ```

                    https://www.lenovo.com/fr/fr/p/workstations/thinkstationp/thinkstation-p5-gen-2-intel-tower-workstation/len102s0024

                    ```


                    ```

                    https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus

                    ```'
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  mpn:
                    type: string
                  sku:
                    type: string
                  url:
                    type: string
                  name:
                    type: string
                  brand:
                    type: string
                  price:
                    type: number
                  title:
                    type: string
                  images:
                    type: array
                    items:
                      type: string
                  series:
                    type: string
                  category:
                    type: string
                  currency:
                    type: string
                  product_id:
                    type: string
                  config_type:
                    type: string
                  description:
                    type: string
                  availability:
                    type: string
                  thumbnail_url:
                    type: string
              examples:
                ThinkStation P5 Gen 2 (France):
                  value:
                    mpn: LEN102S0024
                    sku: LEN102S0024
                    url: https://www.lenovo.com/fr/fr/p/workstations/thinkstationp/thinkstation-p5-gen-2-intel-tower-workstation/len102s0024
                    name: ThinkStation P5 Gen 2 (Intel) Tower
                    brand: Série P
                    price: 4439.02
                    title: ThinkStation P5 Gen 2 (Intel) Tower
                    images:
                    - https://p4-ofp.static.pub/ShareResource/optimized/thinkstation/thinkstation-p5-gen2-intel-tower/lenovo-thinkstation-p5-gen-2-pdp-hero.png
                    series: ThinkStation
                    category: Workstations
                    currency: EUR
                    product_id: LEN102S0024
                    config_type: CTO
                    description: La station de travail tour Lenovo ThinkStation P5 Gen 2 (Intel) offre des performances prêtes pour l’IA, un processeur avancé et une carte graphique professionnelle pour les tâches critiques.
                    availability: in_stock
                    thumbnail_url: https://p4-ofp.static.pub/ShareResource/optimized/thinkstation/thinkstation-p5-gen2-intel-tower/lenovo-thinkstation-p5-gen-2-pdp-hero.png
                ThinkPad E16 Gen 3 (United States):
                  value:
                    mpn: LEN101T0125
                    sku: 21TF001NUS
                    url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus
                    name: ThinkPad E16 Gen 3 (16″ Intel) Laptop
                    brand: ThinkPad
                    price: 1599
                    title: ThinkPad E16 Gen 3 (16″ Intel) Laptop
                    images:
                    - https://p4-ofp.static.pub//fes/cms/2025/04/07/52kiu4uukvy6dnj3ryrs2grmwt7716558555.png
                    series: ThinkPad
                    category: Laptops
                    currency: USD
                    product_id: 21TF001NUS
                    config_type: MTM
                    description: The 16″ Lenovo ThinkPad E16 Gen 3 laptop with Intel® Core™ processors boasts enhanced performance & long battery life for anywhere business.
                    availability: in_stock
                    thumbnail_url: https://p4-ofp.static.pub//fes/cms/2025/04/07/52kiu4uukvy6dnj3ryrs2grmwt7716558555.png
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Lenovo
  /v2/lenovo/search:
    get:
      summary: Lenovo Search
      description: 'Search Lenovo products by keyword or listing URL. Returns product id, price, currency, series, and availability via browser rendering (2 credits).


        **Credit cost:** 2 credits per call'
      operationId: get-lenovo-search
      security:
      - ApiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: true
        description: 'Keyword or full Lenovo search / category URL.


          **Examples:**


          ```

          thinkpad

          ```


          ```

          https://www.lenovo.com/fr/fr/search?fq=&text=thinkpad

          ```


          ```

          https://www.lenovo.com/fr/fr/desktops/subseries-results/?visibleDatas=3906:ThinkStation

          ```'
        schema:
          type: string
          description: 'Keyword or full Lenovo search / category URL.


            **Examples:**


            ```

            thinkpad

            ```


            ```

            https://www.lenovo.com/fr/fr/search?fq=&text=thinkpad

            ```


            ```

            https://www.lenovo.com/fr/fr/desktops/subseries-results/?visibleDatas=3906:ThinkStation

            ```'
      - name: locale
        in: query
        required: false
        description: 'Store locale when `query` is a keyword (ignored for full URLs).


          - `fr/fr` (default, EUR)

          - `de/de` (EUR)

          - `gb/en` (GBP)

          - `us/en` (USD)

          - `es/es` (EUR)

          - `it/it` (EUR)'
        schema:
          type: string
          default: fr/fr
          description: 'Store locale when `query` is a keyword (ignored for full URLs).


            - `fr/fr` (default, EUR)

            - `de/de` (EUR)

            - `gb/en` (GBP)

            - `us/en` (USD)

            - `es/es` (EUR)

            - `it/it` (EUR)'
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      query:
                        type: string
                      current_page:
                        type: integer
                      has_next_page:
                        type: boolean
                      total_results:
                        type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        name:
                          type: string
                        price:
                          type: integer
                        series:
                          type: string
                        currency:
                          type: string
                        product_id:
                          type: string
                        availability:
                          type: string
                        thumbnail_url:
                          type: string
              examples:
                ThinkPad search France:
                  value:
                    meta:
                      query: https://www.lenovo.com/fr/fr/search?fq=&text=thinkpad
                      current_page: 1
                      has_next_page: false
                      total_results: 20
                    results:
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadp/thinkpad-p14s-gen-6-14-inch-amd-mobile-workstation/21qlcto1wwfr1
                      name: ThinkPad P14s Gen 6 (AMD)
                      price: 2519
                      series: ThinkPad
                      currency: EUR
                      product_id: 21QLCTO1WWFR1
                      availability: in_stock
                      thumbnail_url: https://p3-ofp.static.pub/ShareResource/optimized/pdp/thinkpad/thinkpad-p-series/len101t0118/thinkpad-p14s-gen-6-14-amd-series.png?width=584&height=584
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadl/lenovo-thinkpad-l14-gen-6-14-inch-amd/21secto1wwfr4
                      name: ThinkPad L14 Gen 6 (AMD)
                      price: 1759.01
                      series: ThinkPad
                      currency: EUR
                      product_id: 21SECTO1WWFR4
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/ShareResource/we/images/JK-2CD/len101t0144.png?width=584&height=584
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadl/lenovo-thinkpad-l14-gen-6-14-inch-amd/21secto1wwfr3
                      name: ThinkPad L14 Gen 6 (AMD)
                      price: 1623.9
                      series: ThinkPad
                      currency: EUR
                      product_id: 21SECTO1WWFR3
                      availability: in_stock
                      thumbnail_url: https://p4-ofp.static.pub//fes/cms/2026/07/17/vlgy32mp541qdf1eeczc522skq63se938147.png?width=584&height=584
                ThinkPad search United States:
                  value:
                    meta:
                      query: https://www.lenovo.com/us/en/search?fq=&text=thinkpad
                      current_page: 1
                      has_next_page: false
                      total_results: 19
                    results:
                    - url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus
                      name: ThinkPad E16 Gen 3 Intel (16ʺ)
                      price: 1059
                      series: ThinkPad
                      currency: USD
                      product_id: 21TF001NUS
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/medias/26999389948_ThinkPad_E16_3_eclipse_black_202502180427131748491814319.png?width=584&height=584
                    - url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e14-gen-7-14-inch-intel/21t9002hus
                      name: ThinkPad E14 Gen 7 Intel (14″)
                      price: 1059
                      series: ThinkPad
                      currency: USD
                      product_id: 21T9002HUS
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/ShareResource/na/subseries/gallery/lenovo-thinkpad-e14-gen7-intel-14inch.png?width=584&height=584
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Lenovo
    post:
      summary: Lenovo Search
      description: 'Search Lenovo products by keyword or listing URL. Returns product id, price, currency, series, and availability via browser rendering (2 credits).


        **Credit cost:** 2 credits per call'
      operationId: post-lenovo-search
      security:
      - ApiKeyAuth: []
      parameters:
      - $ref: '#/components/parameters/fields'
      - $ref: '#/components/parameters/is_async'
      - $ref: '#/components/parameters/soft_fail'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 'Keyword or full Lenovo search / category URL.


                    **Examples:**


                    ```

                    thinkpad

                    ```


                    ```

                    https://www.lenovo.com/fr/fr/search?fq=&text=thinkpad

                    ```


                    ```

                    https://www.lenovo.com/fr/fr/desktops/subseries-results/?visibleDatas=3906:ThinkStation

                    ```'
                locale:
                  type: string
                  default: fr/fr
                  description: 'Store locale when `query` is a keyword (ignored for full URLs).


                    - `fr/fr` (default, EUR)

                    - `de/de` (EUR)

                    - `gb/en` (GBP)

                    - `us/en` (USD)

                    - `es/es` (EUR)

                    - `it/it` (EUR)'
              required:
              - query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    type: object
                    properties:
                      query:
                        type: string
                      current_page:
                        type: integer
                      has_next_page:
                        type: boolean
                      total_results:
                        type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                        name:
                          type: string
                        price:
                          type: integer
                        series:
                          type: string
                        currency:
                          type: string
                        product_id:
                          type: string
                        availability:
                          type: string
                        thumbnail_url:
                          type: string
              examples:
                ThinkPad search France:
                  value:
                    meta:
                      query: https://www.lenovo.com/fr/fr/search?fq=&text=thinkpad
                      current_page: 1
                      has_next_page: false
                      total_results: 20
                    results:
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadp/thinkpad-p14s-gen-6-14-inch-amd-mobile-workstation/21qlcto1wwfr1
                      name: ThinkPad P14s Gen 6 (AMD)
                      price: 2519
                      series: ThinkPad
                      currency: EUR
                      product_id: 21QLCTO1WWFR1
                      availability: in_stock
                      thumbnail_url: https://p3-ofp.static.pub/ShareResource/optimized/pdp/thinkpad/thinkpad-p-series/len101t0118/thinkpad-p14s-gen-6-14-amd-series.png?width=584&height=584
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadl/lenovo-thinkpad-l14-gen-6-14-inch-amd/21secto1wwfr4
                      name: ThinkPad L14 Gen 6 (AMD)
                      price: 1759.01
                      series: ThinkPad
                      currency: EUR
                      product_id: 21SECTO1WWFR4
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/ShareResource/we/images/JK-2CD/len101t0144.png?width=584&height=584
                    - url: https://www.lenovo.com/fr/fr/p/laptops/thinkpad/thinkpadl/lenovo-thinkpad-l14-gen-6-14-inch-amd/21secto1wwfr3
                      name: ThinkPad L14 Gen 6 (AMD)
                      price: 1623.9
                      series: ThinkPad
                      currency: EUR
                      product_id: 21SECTO1WWFR3
                      availability: in_stock
                      thumbnail_url: https://p4-ofp.static.pub//fes/cms/2026/07/17/vlgy32mp541qdf1eeczc522skq63se938147.png?width=584&height=584
                ThinkPad search United States:
                  value:
                    meta:
                      query: https://www.lenovo.com/us/en/search?fq=&text=thinkpad
                      current_page: 1
                      has_next_page: false
                      total_results: 19
                    results:
                    - url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e16-gen-3-16-inch-intel/21tf001nus
                      name: ThinkPad E16 Gen 3 Intel (16ʺ)
                      price: 1059
                      series: ThinkPad
                      currency: USD
                      product_id: 21TF001NUS
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/medias/26999389948_ThinkPad_E16_3_eclipse_black_202502180427131748491814319.png?width=584&height=584
                    - url: https://www.lenovo.com/us/en/p/laptops/thinkpad/thinkpade/lenovo-thinkpad-e14-gen-7-14-inch-intel/21t9002hus
                      name: ThinkPad E14 Gen 7 Intel (14″)
                      price: 1059
                      series: ThinkPad
                      currency: USD
                      product_id: 21T9002HUS
                      availability: in_stock
                      thumbnail_url: https://p1-ofp.static.pub/ShareResource/na/subseries/gallery/lenovo-thinkpad-e14-gen7-intel-14inch.png?width=584&height=584
        '400':
          description: Bad Request — missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Bad Request
        '401':
          description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalidKey:
                  value:
                    error: Invalid API Key
                planRateLimit:
                  value:
                    error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
                keyQuota:
                  value:
                    error: 'Rate limit exceeded for the API key: quota monthly'
        '402':
          description: Payment Required — your subscription or credit balance is insufficient.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Payment required
        '500':
          description: Internal Server Error — something went wrong on our side.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Internal Error
      tags:
      - Lenovo
components:
  parameters:
    fields:
      name: fields
      in: query
      required: false
      description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
      schema:
        type: string
    is_async:
      name: is_async
      in: query
      required: false
      description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
      schema:
        type: boolean
        default: false
    soft_fail:
      name: soft_fail
      in: query
      required: false
      description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
      schema:
        type: boolean
        default: false
  schemas:
    ErrorResponse:
      type: object
      required:
      - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your API key. Include it in the x-api-key header for every request.