Skip to content

Open RFPs REST API

Published: 2024-05-15

Last Updated: 2026-08-28

Return all active RFPs in MDCMS for a specific application and level. Optional query parameters further limit the list by RFP number, description, status, owner, or linked project, task, and subtask.

GET /open-rfps

JSON payloads

All MDCMS REST API response bodies use JSON.

Authorization

Header Type Required Description
Authorization string Yes Bearer token for the MDSEC user. See Authenticate requests to the MDCMS REST API server.

A missing or invalid token returns HTTP 401 Unauthorized.

Query parameters

Parameter Type Required Description
appl string Yes Application code that contains the RFPs to list.
lvl integer Yes Application level that contains the RFPs to list.
user string No Limit the list to RFPs owned by this user.
rfp integer No Limit the list to this RFP number.
desc string No Substring to match against the RFP description. Any RFP whose description contains this value is returned. Matching is case-insensitive.
status string No Limit the list to RFPs with this status code. RFPs with status 05 (installed) or 09 (closed) are never returned.
project string No Limit the list to RFPs that contain at least one object request linked to this project.
task integer No Limit the list to RFPs that contain at least one object request linked to this task.
subtask integer No Limit the list to RFPs that contain at least one object request linked to this subtask.

project, task, and subtask can be combined. When any of them is supplied, only RFPs with a matching project/task/subtask assignment on an object request are returned.

Example

Replace {endpoint} with the URL endpoint defined for the MDCMS HTTP server.

curl -H "Authorization: Bearer {token}" \
  "https://{endpoint}/open-rfps?appl=TEST&lvl=10&desc=demo&status=00&project=DEMO044"

GET /open-rfps?appl=TEST&lvl=10&desc=demo&status=00&project=DEMO044 HTTP/1.1
Host: {endpoint}
Authorization: Bearer {token}

Response body

Schema

Property Type Description
rfps array List of RFP objects.

RFP object

Property Type Description
appl string Application code.
lvl integer Application level.
rfp integer RFP number.
user string User that owns the RFP.
desc string RFP description.
status string RFP status code.

Example

{
  "rfps": [
    {
      "appl": "TEST",
      "lvl": "10",
      "rfp": "1340",
      "user": "MMORGAN",
      "desc": "Git contents of a Tag",
      "status": "00"
    },
    {
      "appl": "TEST",
      "lvl": "10",
      "rfp": "1605",
      "user": "MMORGAN",
      "desc": "test mdlmövo",
      "status": "01"
    },
    {
      "appl": "TEST",
      "lvl": "10",
      "rfp": "1731",
      "user": "MMORGAN",
      "desc": "8.2 demo",
      "status": "00"
    }
  ]
}
Resource Description
RFP Submission REST API Submit RFPs for verification and compile
RFP Approval REST API Approve RFPs for installation
Object Request REST API Create or update an object request
Object Requests REST API List or delete object requests
Open Projects REST API List active projects
Open Tasks REST API List active tasks for a project
Open Subtasks REST API List active subtasks for a project and task