List Production Schedule Finishing Lines

Beta

GET/v1/operations/production-schedules/{id}/finishing-lines

This endpoint is idempotent. Learn more

Returns the second stage of a schedule: how many of which finished good to make from the knitted parts, week by week.

The constraint plan says how much greige to knit and deliberately does not say what to turn it into — a family's demand is pooled onto the greige precisely so the buffer can sit at the undifferentiated stage, where it is cheapest. These lines are where that pooling is undone, against each finished SKU's own stock position, its own orders, and the hours the rest of the factory has that week.

Levelled, not merely allocated. Work that does not fit a week moves to the next one rather than being dropped, so the plan never asks the second stage for more hours than it has. Two things bound it, and they are reported separately in the schedule's diagnostics because they call for opposite responses: a SKU held back for want of greige is a knitting problem, and a SKU held back for want of hours is a finishing one.

Everything is counted in the constraint item's unit, so greige_consumed here and planned_quantity on the constraint plan are directly comparable — which is what lets the two stages be reconciled rather than only read side by side.

Permissions requiredValues:production_schedules:read

The role behind your API key or agent must grant every one of these permissions.

idstring

ID of the schedule version.

week_indexoptional integer

Only the finishing planned for this week, zero-based from the start of the horizon.

item_idoptional string

Only the finishing planned for this finished good.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of production_schedule_finishing_line

Resources in this page.

idstring

Finishing line ID.

objectstringenumValues:production_schedule_finishing_line

Resource type identifier.

production_scheduleentitynullable

The schedule version this belongs to.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

week_indexinteger

Zero-based week offset from the start of the horizon.

week_starts_atstring (date-time)

First day of the week this is planned in.

itementitynullable

The finished good to make.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

skustring

SKU of the finished good, as it stood when the plan was generated.

greige_itementitynullable

The constraint item it is made from.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

greige_skustring

SKU of that constraint item.

departmententitynullable

The department that does the work.

Absent for a finished good nobody has ever scanned a finishing step for, which means the plan knows what to make but not yet where.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

production_stepentitynullable

The production step the work runs at.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

planned_quantitynumber

Units of the finished good to make.

unitstringnullable

Abbreviation of the unit everything on this line is counted in.

planned_lotsinteger

How many lots the quantity breaks into.

planned_lot_unitsnumber

Units in one lot.

planned_run_hoursnumber

Hours of the second stage's capacity this line consumes.

greige_consumednumber

Units of the constraint item this takes out of the greige buffer.

Equal to planned_quantity unless a finishing yield loss means a finished unit costs more than one knitted one.

firm_unitsnumber

How much of the week's draw on this SKU is an order rather than a forecast.

projected_on_hand_beforenumber

This SKU's own projected stock before the line lands.

projected_on_hand_afternumber

And after it lands.

statusstringenumValues:plannedreleasedin_progress

Where the line stands.

sourcestringenumValues:solvermanual

Whether the solver produced this line or a person did.

is_frozenboolean

Whether the line sits inside the published frozen window.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Production Schedule Finishing Lines

List Production Schedule Finishing Lines

import OpenMRP from '@openmrp/sdk';

const client = new OpenMRP({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listProductionScheduleFinishingLine =
  await client.operations.productionSchedules.retrieveFinishingLines('pnsc_m4zt3z8g8src');

console.log(listProductionScheduleFinishingLine.data);

import OpenMRP from '@openmrp/sdk';

const client = new OpenMRP({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listProductionScheduleFinishingLine =
  await client.operations.productionSchedules.retrieveFinishingLines('pnsc_m4zt3z8g8src');

console.log(listProductionScheduleFinishingLine.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/operations/production-schedules/pnsc_m4zt3z8g8src/finishing-lines?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoicG5zY2ZpbG5fOGRxNG12NzFwemtvIiwiZCI6ImYifQ.NQOgs5fHpEqn5F9PNyXMYoEsUWL92YEfwSciR2S-oWY",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "pnscfiln_8dq4mv71pzko",
      "object": "production_schedule_finishing_line",
      "production_schedule": {
        "id": "pnsc_m4zt3z8g8src",
        "object": "entity",
        "type": "production_schedule",
        "name": null,
        "handle": null
      },
      "week_index": 2,
      "week_starts_at": "2026-05-10T00:00:00Z",
      "item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": null
      },
      "sku": "MZ-CREW-BLK-L",
      "greige_item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": null
      },
      "greige_sku": "MZ-GREIGE-CREW",
      "department": {
        "id": "dp_m0jayebxnkos",
        "object": "entity",
        "type": "department",
        "name": null,
        "handle": null
      },
      "production_step": null,
      "planned_quantity": 240,
      "unit": "pr",
      "planned_lots": 4,
      "planned_lot_units": 60,
      "planned_run_hours": 19.2,
      "greige_consumed": 240,
      "firm_units": 120,
      "projected_on_hand_before": 180,
      "projected_on_hand_after": 420,
      "status": "planned",
      "source": "solver",
      "is_frozen": false,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/operations/production-schedules/pnsc_m4zt3z8g8src/finishing-lines?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoicG5zY2ZpbG5fOGRxNG12NzFwemtvIiwiZCI6ImYifQ.NQOgs5fHpEqn5F9PNyXMYoEsUWL92YEfwSciR2S-oWY",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "pnscfiln_8dq4mv71pzko",
      "object": "production_schedule_finishing_line",
      "production_schedule": {
        "id": "pnsc_m4zt3z8g8src",
        "object": "entity",
        "type": "production_schedule",
        "name": null,
        "handle": null
      },
      "week_index": 2,
      "week_starts_at": "2026-05-10T00:00:00Z",
      "item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": null
      },
      "sku": "MZ-CREW-BLK-L",
      "greige_item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": null
      },
      "greige_sku": "MZ-GREIGE-CREW",
      "department": {
        "id": "dp_m0jayebxnkos",
        "object": "entity",
        "type": "department",
        "name": null,
        "handle": null
      },
      "production_step": null,
      "planned_quantity": 240,
      "unit": "pr",
      "planned_lots": 4,
      "planned_lot_units": 60,
      "planned_run_hours": 19.2,
      "greige_consumed": 240,
      "firm_units": 120,
      "projected_on_hand_before": 180,
      "projected_on_hand_after": 420,
      "status": "planned",
      "source": "solver",
      "is_frozen": false,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Production Schedule Finishing Lines

Authorization

Path Parameters

Query Parameters

Returns

Responses