> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shoppex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Claim product serials

> Atomically claims and removes the requested number of available serials from a base serial product without variants, then returns the claimed serial values plus the updated remaining stock. Use this endpoint when you want serial values directly and do not want to manually fetch serial IDs first.



## OpenAPI

````yaml /openapi.json post /dev/v1/products/{id}/serials/claim
openapi: 3.0.3
info:
  title: Shoppex Developer API
  description: Mintlify-compatible Developer API reference for Shoppex.
  version: 1.0.0
  contact:
    name: Shoppex Support
    email: support@shoppex.io
    url: https://shoppex.io
servers:
  - url: https://api.shoppex.io
security:
  - bearerAuth: []
paths:
  /dev/v1/products/{id}/serials/claim:
    post:
      tags:
        - Products
      summary: Claim product serials
      description: >-
        Atomically claims and removes the requested number of available serials
        from a base serial product without variants, then returns the claimed
        serial values plus the updated remaining stock. Use this endpoint when
        you want serial values directly and do not want to manually fetch serial
        IDs first.
      operationId: postDevV1ProductsByIdSerialsClaim
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - amount
              properties:
                amount:
                  type: number
                  minimum: 1
                  maximum: 500
              example:
                amount: 2
          multipart/form-data:
            schema:
              type: object
              required:
                - amount
              properties:
                amount:
                  type: number
                  minimum: 1
                  maximum: 500
              example:
                amount: 2
          text/plain:
            schema:
              type: object
              required:
                - amount
              properties:
                amount:
                  type: number
                  minimum: 1
                  maximum: 500
              example:
                amount: 2
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    additionalProperties: true
                example:
                  data:
                    claimed_count: 2
                    remaining_stock: 7
                    serials:
                      - id: serial_1
                        serial: ABC-123
                        variant_id: null
                        variant_title: null
                        created_at: '2026-03-16T10:00:00.000Z'
                      - id: serial_2
                        serial: XYZ-789
                        variant_id: null
                        variant_title: null
                        created_at: '2026-03-16T10:01:00.000Z'
      deprecated: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Use your Shoppex API key in the Authorization header.

````