Retraced Product / BOM Lines API

The Product / BOM Lines API from Retraced — 3 operation(s) for product / bom lines.

Operations 4

POST /api/v2/bom-lines/ Create api bom lines #
GET /api/v2/bom-lines/ Get api bom lines #
POST /api/v2/bom-lines/delete Create api bom lines delete #
PUT /api/v2/bom-lines/{id} Replace api bom lines by id #

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/retraced-product-bom-lines-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

retraced-product-bom-lines-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Public API Reference Product / BOM Lines API
  description: 'The retraced API comprises all publicly enabled options to make

    machine-to-machine changes in the retraced platform.'
  version: 2.938.1
servers: []
tags:
- name: Product / BOM Lines
paths:
  /api/v2/bom-lines/:
    post:
      tags:
      - Product / BOM Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                bomHeaderId:
                  type: string
                  minLength: 1
                placementId:
                  anyOf:
                  - type: string
                  - type: 'null'
                entity:
                  type: object
                  properties:
                    styleId:
                      type: string
                      minLength: 1
                  required:
                  - styleId
                quantity:
                  anyOf:
                  - type: number
                    minimum: 0
                  - type: 'null'
                quantityUnit:
                  anyOf:
                  - type: string
                    enum:
                    - PIECES
                    - PAIR
                    - PERCENTAGE
                    - DENIER
                    - JUTE
                    - ENGLISH_COUNT
                    - METRIC_COUNT
                    - WORSTED_COUNT
                    - TEX
                    - GRAM
                    - KILOGRAM
                    - LITRE
                    - METRIC_TON
                    - MILLIMETRE
                    - CENTIMETRE
                    - METRE
                    - SQUARE_CENTIMETRE
                    - SQUARE_METRE
                  - type: 'null'
                weight:
                  anyOf:
                  - type: number
                    minimum: 0
                  - type: 'null'
                weightUnit:
                  anyOf:
                  - type: string
                    enum:
                    - GRAM
                    - GRAM_PER_SQUARE_METER
                    - GRAM_PER_SQUARE_FOOT
                    - GRAM_PER_SQUARE_YARD
                    - OUNCE_PER_SQUARE_YARD
                    - MILLIGRAM
                    - KILOGRAM
                    - METRIC_TON
                    - POUNDS
                    - SHORT_TON
                    - LONG_TON
                    - HUNDREDWEIGHT
                    - SHORT_HUNDREDWEIGHT
                    - LONG_HUNDREDWEIGHT
                    - OUNCE
                    - DRAM
                    - GRAIN
                    - PENNYWEIGHT
                    - SCRUPLE
                    - STONE
                  - type: 'null'
                countryOfOrigin:
                  anyOf:
                  - type: string
                    maxLength: 100
                  - type: 'null'
                isMainComponent:
                  default: false
                  type: boolean
                component:
                  type: object
                  properties:
                    styleId:
                      type: string
                      minLength: 1
                  required:
                  - styleId
              required:
              - bomHeaderId
              - entity
              - component
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      bomHeaderId:
                        type: string
                      placementId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      styleId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      quantity:
                        anyOf:
                        - type: number
                        - type: 'null'
                      quantityUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      weight:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weightUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      countryOfOrigin:
                        anyOf:
                        - type: string
                        - type: 'null'
                      isMainComponent:
                        type: boolean
                      createdAt:
                        type: string
                      createdByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      createdByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedAt:
                        type: string
                      updatedByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                    required:
                    - id
                    - bomHeaderId
                    - placementId
                    - styleId
                    - quantity
                    - quantityUnit
                    - weight
                    - weightUnit
                    - countryOfOrigin
                    - isMainComponent
                    - createdAt
                    - createdByUserId
                    - createdByCompanyId
                    - updatedAt
                    - updatedByUserId
                    - updatedByCompanyId
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Create api bom lines
      x-summary-source: derived
      operationId: postApiV2BomLines
      x-operation-id-source: derived
    get:
      tags:
      - Product / BOM Lines
      parameters:
      - schema:
          default: 1
          type: integer
          minimum: 1
          maximum: 9007199254740991
        in: query
        name: page
        required: false
      - schema:
          default: 20
          type: integer
          minimum: 1
          maximum: 100
        in: query
        name: limit
        required: false
      - schema:
          default: desc
          type: string
          enum:
          - asc
          - desc
          - ASC
          - DESC
        in: query
        name: order
        required: false
      - schema:
          default: createdAt
          type: string
          enum:
          - createdAt
          - updatedAt
          - quantity
          - weight
        in: query
        name: sort
        required: false
      - schema:
          type: string
        in: query
        name: bomHeaderId
        required: false
      - schema:
          type: string
        in: query
        name: styleId
        required: false
      - schema:
          type: string
        in: query
        name: placementId
        required: false
      - schema:
          type: string
        in: query
        name: countryOfOrigin
        required: false
      - schema:
          anyOf:
          - type: boolean
          - type: string
            enum:
            - 'true'
          - type: string
            enum:
            - 'false'
        in: query
        name: isMainComponent
        required: false
      - schema:
          type: string
        in: query
        name: include
        required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        bomHeaderId:
                          type: string
                        placementId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        styleId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        quantity:
                          anyOf:
                          - type: number
                          - type: 'null'
                        quantityUnit:
                          anyOf:
                          - type: string
                          - type: 'null'
                        weight:
                          anyOf:
                          - type: number
                          - type: 'null'
                        weightUnit:
                          anyOf:
                          - type: string
                          - type: 'null'
                        countryOfOrigin:
                          anyOf:
                          - type: string
                          - type: 'null'
                        isMainComponent:
                          type: boolean
                        createdAt:
                          type: string
                        createdByUserId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        createdByCompanyId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        updatedAt:
                          type: string
                        updatedByUserId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        updatedByCompanyId:
                          anyOf:
                          - type: string
                          - type: 'null'
                        entity:
                          type: object
                          properties:
                            id:
                              type: string
                            forCompanyId:
                              type: string
                            codes:
                              type: array
                              items:
                                type: object
                                properties:
                                  codeId:
                                    type: string
                                  codeValue:
                                    type: string
                                required:
                                - codeId
                                - codeValue
                                additionalProperties: false
                            name:
                              type: string
                            suppliers:
                              anyOf:
                              - type: array
                                items:
                                  type: string
                              - type: 'null'
                            mainSupplier:
                              anyOf:
                              - type: string
                              - type: 'null'
                          required:
                          - id
                          - forCompanyId
                          - codes
                          - name
                          - suppliers
                          - mainSupplier
                          additionalProperties: false
                        placement:
                          type: object
                          properties:
                            id:
                              type: string
                            value:
                              type: string
                            forCompanyId:
                              type: string
                          required:
                          - id
                          - value
                          - forCompanyId
                          additionalProperties: false
                      required:
                      - id
                      - bomHeaderId
                      - placementId
                      - styleId
                      - quantity
                      - quantityUnit
                      - weight
                      - weightUnit
                      - countryOfOrigin
                      - isMainComponent
                      - createdAt
                      - createdByUserId
                      - createdByCompanyId
                      - updatedAt
                      - updatedByUserId
                      - updatedByCompanyId
                      additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Get api bom lines
      x-summary-source: derived
      operationId: getApiV2BomLines
      x-operation-id-source: derived
  /api/v2/bom-lines/delete:
    post:
      tags:
      - Product / BOM Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                bomLineIds:
                  minItems: 1
                  maxItems: 100
                  type: array
                  items:
                    type: string
                    minLength: 1
                styleId:
                  type: string
                  minLength: 1
              required:
              - bomLineIds
              - styleId
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      deletedLines:
                        description: IDs of successfully deleted BOM lines
                        type: array
                        items:
                          type: string
                      duplicatedHeaders:
                        description: Details of headers that were duplicated for child entities
                        type: array
                        items:
                          type: object
                          properties:
                            originalHeaderId:
                              type: string
                            newHeaderId:
                              type: string
                            forEntityId:
                              type: string
                            entityType:
                              type: string
                              enum:
                              - style
                              - variant
                              - sku
                          required:
                          - originalHeaderId
                          - newHeaderId
                          - forEntityId
                          - entityType
                          additionalProperties: false
                      orphanedHeaders:
                        description: IDs of headers that were cleaned up
                        type: array
                        items:
                          type: string
                      errors:
                        description: Errors encountered during deletion process
                        type: array
                        items:
                          type: object
                          properties:
                            bomLineId:
                              type: string
                            error:
                              type: string
                          required:
                          - bomLineId
                          - error
                          additionalProperties: false
                    required:
                    - deletedLines
                    - duplicatedHeaders
                    - orphanedHeaders
                    - errors
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Create api bom lines delete
      x-summary-source: derived
      operationId: postApiV2BomLinesDelete
      x-operation-id-source: derived
  /api/v2/bom-lines/{id}:
    put:
      tags:
      - Product / BOM Lines
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                entity:
                  type: object
                  properties:
                    styleId:
                      type: string
                      minLength: 1
                  required:
                  - styleId
                component:
                  type: object
                  properties:
                    styleId:
                      type: string
                      minLength: 1
                  required:
                  - styleId
                placementId:
                  anyOf:
                  - type: string
                  - type: 'null'
                quantity:
                  anyOf:
                  - type: number
                    minimum: 0
                  - type: 'null'
                quantityUnit:
                  anyOf:
                  - type: string
                    enum:
                    - PIECES
                    - PAIR
                    - PERCENTAGE
                    - DENIER
                    - JUTE
                    - ENGLISH_COUNT
                    - METRIC_COUNT
                    - WORSTED_COUNT
                    - TEX
                    - GRAM
                    - KILOGRAM
                    - LITRE
                    - METRIC_TON
                    - MILLIMETRE
                    - CENTIMETRE
                    - METRE
                    - SQUARE_CENTIMETRE
                    - SQUARE_METRE
                  - type: 'null'
                weight:
                  anyOf:
                  - type: number
                    minimum: 0
                  - type: 'null'
                weightUnit:
                  anyOf:
                  - type: string
                    enum:
                    - GRAM
                    - GRAM_PER_SQUARE_METER
                    - GRAM_PER_SQUARE_FOOT
                    - GRAM_PER_SQUARE_YARD
                    - OUNCE_PER_SQUARE_YARD
                    - MILLIGRAM
                    - KILOGRAM
                    - METRIC_TON
                    - POUNDS
                    - SHORT_TON
                    - LONG_TON
                    - HUNDREDWEIGHT
                    - SHORT_HUNDREDWEIGHT
                    - LONG_HUNDREDWEIGHT
                    - OUNCE
                    - DRAM
                    - GRAIN
                    - PENNYWEIGHT
                    - SCRUPLE
                    - STONE
                  - type: 'null'
                countryOfOrigin:
                  anyOf:
                  - type: string
                    maxLength: 100
                  - type: 'null'
                isMainComponent:
                  type: boolean
              required:
              - entity
              - component
      parameters:
      - schema:
          type: string
          minLength: 1
        in: path
        name: id
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      success:
                        default: true
                        type: boolean
                      pagination:
                        type: object
                        properties:
                          page:
                            default: 1
                            type: number
                          limit:
                            default: 10
                            type: number
                          total:
                            default: 0
                            type: number
                          totalPages:
                            default: 0
                            type: number
                        required:
                        - page
                        - limit
                        - total
                        - totalPages
                        additionalProperties: false
                    required:
                    - success
                    additionalProperties: false
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      bomHeaderId:
                        type: string
                      placementId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      styleId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      quantity:
                        anyOf:
                        - type: number
                        - type: 'null'
                      quantityUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      weight:
                        anyOf:
                        - type: number
                        - type: 'null'
                      weightUnit:
                        anyOf:
                        - type: string
                        - type: 'null'
                      countryOfOrigin:
                        anyOf:
                        - type: string
                        - type: 'null'
                      isMainComponent:
                        type: boolean
                      createdAt:
                        type: string
                      createdByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      createdByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedAt:
                        type: string
                      updatedByUserId:
                        anyOf:
                        - type: string
                        - type: 'null'
                      updatedByCompanyId:
                        anyOf:
                        - type: string
                        - type: 'null'
                    required:
                    - id
                    - bomHeaderId
                    - placementId
                    - styleId
                    - quantity
                    - quantityUnit
                    - weight
                    - weightUnit
                    - countryOfOrigin
                    - isMainComponent
                    - createdAt
                    - createdByUserId
                    - createdByCompanyId
                    - updatedAt
                    - updatedByUserId
                    - updatedByCompanyId
                    additionalProperties: false
                required:
                - metadata
                - data
                additionalProperties: false
      summary: Replace api bom lines by id
      x-summary-source: derived
      operationId: putApiV2BomLinesById
      x-operation-id-source: derived