{
  "info": {
    "_postman_id": "cb1e43dc-4999-4d79-ae86-0dd533f06bdd",
    "name": "MindBill Partner API v2",
    "description": "One bill resource, explicit documents, lifecycle actions, and short-lived browser sessions. Use synthetic data in sandbox.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://app.mindbill.org/partner/v2",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "",
      "type": "string"
    },
    {
      "key": "billId",
      "value": "sandbox-bill",
      "type": "string"
    },
    {
      "key": "documentId",
      "value": "sandbox-document",
      "type": "string"
    },
    {
      "key": "reviewId",
      "value": "sandbox-review",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Bills",
      "item": [
        {
          "name": "List bills",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills"
              ]
            },
            "description": "List bills"
          },
          "response": []
        },
        {
          "name": "Create a bill",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills"
              ]
            },
            "description": "Create a bill",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"externalId\": \"case-42-report-1\",\n  \"billingMode\": \"med_legal\",\n  \"patient\": {\n    \"externalId\": \"patient-42\",\n    \"firstName\": \"Alex\",\n    \"lastName\": \"Morgan\",\n    \"dateOfBirth\": \"1980-04-12\",\n    \"address\": {\n      \"line1\": \"100 Main St\",\n      \"city\": \"Pasadena\",\n      \"state\": \"CA\",\n      \"postalCode\": \"91101\"\n    }\n  },\n  \"claim\": {\n    \"externalId\": \"claim-42\",\n    \"claimNumber\": \"DEMO-WC-42\",\n    \"employer\": \"Example Employer\",\n    \"dateOfInjury\": \"2026-02-14\",\n    \"injuryState\": \"CA\",\n    \"claimsAdministrator\": {\n      \"name\": \"Example Claims Administrator\"\n    }\n  },\n  \"service\": {\n    \"date\": \"2026-08-11\"\n  },\n  \"renderingProvider\": {\n    \"name\": \"Dr. Morgan Chen\",\n    \"npi\": \"1114023058\",\n    \"licenseState\": \"CA\"\n  },\n  \"serviceLocation\": {\n    \"name\": \"Pasadena Exam Office\",\n    \"address\": {\n      \"line1\": \"200 Oak Ave\",\n      \"city\": \"Pasadena\",\n      \"state\": \"CA\",\n      \"postalCode\": \"91101\"\n    },\n    \"placeOfServiceCode\": \"11\"\n  },\n  \"diagnoses\": [\n    \"M25.512\"\n  ],\n  \"serviceLines\": [\n    {\n      \"code\": \"ML201\",\n      \"modifiers\": [\n        \"95\"\n      ],\n      \"units\": 1\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get a bill",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}"
              ]
            },
            "description": "Get a bill"
          },
          "response": []
        },
        {
          "name": "Update a bill",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}"
              ]
            },
            "description": "Update a bill",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"claim\": {\n    \"employer\": \"Updated Example Employer\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "List payer-packet documents",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "documents"
              ]
            },
            "description": "List payer-packet documents"
          },
          "response": []
        },
        {
          "name": "Attach a PDF",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/documents",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "documents"
              ]
            },
            "description": "Attach a PDF",
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "file",
                  "type": "file",
                  "src": []
                },
                {
                  "key": "documentType",
                  "type": "text",
                  "value": "final_report"
                },
                {
                  "key": "externalId",
                  "type": "text",
                  "value": "report-42"
                }
              ]
            }
          },
          "response": []
        },
        {
          "name": "Download a PDF",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/documents/{{documentId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "documents",
                "{{documentId}}"
              ]
            },
            "description": "Download a PDF"
          },
          "response": []
        },
        {
          "name": "Remove a PDF",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/documents/{{documentId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "documents",
                "{{documentId}}"
              ]
            },
            "description": "Remove a PDF"
          },
          "response": []
        },
        {
          "name": "Submit a bill",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/submissions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "submissions"
              ]
            },
            "description": "Submit a bill",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"route\": \"ebill\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get bill status",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/status",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "status"
              ]
            },
            "description": "Get bill status"
          },
          "response": []
        },
        {
          "name": "Get EOR and payment details",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/eor",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "eor"
              ]
            },
            "description": "Get EOR and payment details"
          },
          "response": []
        },
        {
          "name": "Perform the next bill action",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/actions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "actions"
              ]
            },
            "description": "Perform the next bill action",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"post_payment\",\n  \"amount\": 503.75,\n  \"method\": \"check\",\n  \"depositDate\": \"2026-08-25\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "List bill reviews",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/reviews",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "reviews"
              ]
            },
            "description": "List bill reviews"
          },
          "response": []
        },
        {
          "name": "Create a bill review",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/reviews",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "reviews"
              ]
            },
            "description": "Create a bill review",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"externalId\": \"review-42\",\n  \"type\": \"second_review\",\n  \"reason\": \"The EOR did not allow the documented service.\",\n  \"disputedAmount\": 503.75,\n  \"payerClaimControlNumber\": \"PCN-DEMO-42\",\n  \"attachmentIds\": [\n    \"{{documentId}}\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Get a bill review",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/reviews/{{reviewId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "reviews",
                "{{reviewId}}"
              ]
            },
            "description": "Get a bill review"
          },
          "response": []
        },
        {
          "name": "Submit a bill review",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{$guid}}",
                "type": "text"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/bills/{{billId}}/reviews/{{reviewId}}/submissions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "bills",
                "{{billId}}",
                "reviews",
                "{{reviewId}}",
                "submissions"
              ]
            },
            "description": "Submit a bill review",
            "body": {
              "mode": "raw",
              "raw": "{}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "List lifecycle events",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "events"
              ]
            },
            "description": "List lifecycle events"
          },
          "response": []
        },
        {
          "name": "List webhook deliveries",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/webhook-deliveries",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook-deliveries"
              ]
            },
            "description": "List webhook deliveries"
          },
          "response": []
        },
        {
          "name": "Mint an origin-bound browser session",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/browser-sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "browser-sessions"
              ]
            },
            "description": "Mint an origin-bound browser session",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"component\": \"bill-review\",\n  \"billId\": \"{{billId}}\",\n  \"allowedOrigin\": \"https://partner.example.test\",\n  \"expiresIn\": 900\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    }
  ]
}