List Production Schedule Derived Lines

Beta

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

This endpoint is idempotent. Learn more

Returns the department work implied by a schedule's constraint plan.

The solver schedules only the constraint; every other department's work is derived from it by walking the production-step graph, applying each step's lead-time offset and yield. That makes this the work list a supervisor reads, rather than a second plan someone has to maintain.

explosion_depth is how many steps downstream the work sits, which is what a readiness indicator keys off. Depth 0 is the constraint's own campaigns, so a plant with nothing configured downstream of its constraint still gets the work it actually scheduled. Work whose derived week falls past the schedule's horizon is still returned — a department needs to see it coming.

Permissions requiredValues:production_schedules:read

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

idstring

ID of the production schedule.

department_ids[]optional array

Only return work owned by these departments.

week_indexoptional integer

Only return work in this horizon week, zero-based.

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_derived_line

Resources in this page.

idstring

Derived line ID.

objectstringenumValues:production_schedule_derived_line

Resource type identifier.

production_scheduleentitynullable

The schedule version this work was derived 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).

source_lineentitynullable

The constraint campaign this work follows 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).

production_stepentitynullable

The production step that does the work.

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).

departmententitynullable

The department that owns the step.

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).

itementitynullable

The item being worked on.

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

Horizon week the work falls in, zero-based.

week_starts_atstring (date-time)

First instant of that week.

quantitynumber

Units implied for this step.

planned_unitentitynullable

The unit the quantity is expressed in.

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).

explosion_depthinteger

How many steps downstream of the constraint this work sits.

offset_weeksinteger

Weeks after the constraint campaign this work starts.

statusstringenumValues:plannedreleasedin_progress

State of the derived work.

Derived rows are discarded and rebuilt from the constraint plan every time the version is solved, and are only ever written as planned, so they report what the plan implies rather than what the floor has done.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Production Schedule Derived Lines

List Production Schedule Derived Lines

import OpenMRP from '@openmrp/sdk';

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

const listProductionScheduleDerivedLine =
  await client.operations.productionSchedules.retrieveDerivedLines('pnsc_m4zt3z8g8src');

console.log(listProductionScheduleDerivedLine.data);

import OpenMRP from '@openmrp/sdk';

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

const listProductionScheduleDerivedLine =
  await client.operations.productionSchedules.retrieveDerivedLines('pnsc_m4zt3z8g8src');

console.log(listProductionScheduleDerivedLine.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/operations/production-schedules/pnsc_m4zt3z8g8src/derived-lines?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoicG5zY2RsX3o5cmkxbmlkcTc1cyIsImQiOiJmIn0.gueY7RjSs0c03Jkr98IdHTQy64OYTK1M_D7EW8TpJFU",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "pnscdl_z9ri1nidq75s",
      "object": "production_schedule_derived_line",
      "production_schedule": {
        "id": "pnsc_m4zt3z8g8src",
        "object": "entity",
        "type": "production_schedule",
        "name": null,
        "handle": null
      },
      "source_line": {
        "id": "pnscln_l28dutdpl81r",
        "object": "entity",
        "type": "production_schedule_line",
        "name": null,
        "handle": null
      },
      "production_step": {
        "id": "prst_0ht5mkqx5a6t",
        "object": "entity",
        "type": "production_step",
        "name": "Final Assembly",
        "handle": null
      },
      "department": {
        "id": "dp_m0jayebxnkos",
        "object": "entity",
        "type": "department",
        "name": "Fabrication",
        "handle": null
      },
      "item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": "MZ-GREIGE-CREW"
      },
      "week_index": 1,
      "week_starts_at": "2026-05-17T00:00:00Z",
      "quantity": 600,
      "planned_unit": {
        "id": "un_82bd37dae5po",
        "object": "entity",
        "type": "unit",
        "name": "Pair",
        "handle": null
      },
      "explosion_depth": 1,
      "offset_weeks": 1,
      "status": "planned",
      "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/derived-lines?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoicG5zY2RsX3o5cmkxbmlkcTc1cyIsImQiOiJmIn0.gueY7RjSs0c03Jkr98IdHTQy64OYTK1M_D7EW8TpJFU",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "pnscdl_z9ri1nidq75s",
      "object": "production_schedule_derived_line",
      "production_schedule": {
        "id": "pnsc_m4zt3z8g8src",
        "object": "entity",
        "type": "production_schedule",
        "name": null,
        "handle": null
      },
      "source_line": {
        "id": "pnscln_l28dutdpl81r",
        "object": "entity",
        "type": "production_schedule_line",
        "name": null,
        "handle": null
      },
      "production_step": {
        "id": "prst_0ht5mkqx5a6t",
        "object": "entity",
        "type": "production_step",
        "name": "Final Assembly",
        "handle": null
      },
      "department": {
        "id": "dp_m0jayebxnkos",
        "object": "entity",
        "type": "department",
        "name": "Fabrication",
        "handle": null
      },
      "item": {
        "id": "it_pej07ckhvu62",
        "object": "entity",
        "type": "item",
        "name": null,
        "handle": "MZ-GREIGE-CREW"
      },
      "week_index": 1,
      "week_starts_at": "2026-05-17T00:00:00Z",
      "quantity": 600,
      "planned_unit": {
        "id": "un_82bd37dae5po",
        "object": "entity",
        "type": "unit",
        "name": "Pair",
        "handle": null
      },
      "explosion_depth": 1,
      "offset_weeks": 1,
      "status": "planned",
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Production Schedule Derived Lines

Authorization

Path Parameters

Query Parameters

Returns

Responses