Dealroom

Every contract type Dealroom can make, with the code to use as contractType, the guide slug, the governing laws and languages it is offered in, the role the caller can take (DPA and BAA only) and the inputs it asks for. Each input says whether it is required and, when it has one, its default; mustSend marks the required inputs without a default. Send every required input in terms. A required input with a default can be left out: the default is applied. Call this first to know what to ask the user. Send contractType to get one type with its inputs, or summary true to get every type without its inputs (a short list of codes). No API key needed.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en",
      "description": "Language of names and labels"
    },
    "contractType": {
      "type": "string",
      "description": "Optional: one code (for example DPA) or guide slug; only that type is returned, with its inputs"
    },
    "summary": {
      "type": "boolean",
      "default": false,
      "description": "Optional: leave the inputs out of each type (each then carries inputCount)"
    }
  },
  "required": []
}

Make a finished contract in one call: give the contract type, your side's details and, if you know them, the other side's. Clauses you leave out take the template's middle-ground option (the most neutral one; for an optional clause such as non-solicitation, none), never simply the first option listed. One prepaid credit is spent (the same price as any contract); with no credit the answer is HTTP 402 with code PAYMENT_REQUIRED and nothing is created. Returns the contract as Markdown, then the deal id, the link where the person can read it in Dealroom and the Markdown, HTML, PDF, DOCX and TXT links (free to fetch again).

{
  "type": "object",
  "properties": {
    "contractType": {
      "type": "string",
      "description": "Code (for example NDA) or guide slug (for example nda), from list_contract_types"
    },
    "governingLaw": {
      "type": "string",
      "enum": [
        "CALIFORNIA",
        "ENGLAND_WALES",
        "SPAIN",
        "DELAWARE"
      ],
      "description": "Required when the contract type offers more than one"
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en"
    },
    "title": {
      "type": "string",
      "description": "Name of the deal; made from the parties when left out"
    },
    "party": {
      "type": "object",
      "description": "Your side (the side the API key acts for). Send every detail you have: only what you send is written into the contract.",
      "properties": {
        "legalName": {
          "type": "string",
          "description": "Full legal name of the company or person. Printed as the party's name in the preamble, the Parties section and the signature block."
        },
        "address": {
          "type": "string",
          "description": "Registered office or principal place of business, for example \"Calle Mayor 1, 28013 Madrid, Spain\". Printed in the preamble (\"with its principal place of business at ...\") and the Parties section. Left out: [Address] stays as a blank to fill in."
        },
        "jurisdiction": {
          "type": "string",
          "description": "Where the party is incorporated or registered, for example \"Spain\" or \"Delaware, United States\". Printed in the Parties section of the Markdown, HTML and text versions."
        },
        "taxId": {
          "type": "string",
          "description": "Company or tax number (for example a Spanish NIF or a US EIN). Printed in the Parties section of the Markdown, HTML and text versions, and in the preamble where the template shows one."
        },
        "signatoryName": {
          "type": "string",
          "description": "Name of the person who signs. Printed in the signature block; left out, the Name line stays blank."
        },
        "signatoryTitle": {
          "type": "string",
          "description": "Title of the person who signs, for example CEO. Printed in the signature block; left out, the Title line stays blank."
        },
        "contact": {
          "type": "string",
          "description": "Contact person or details for the Contact line of the Parties section (Markdown, HTML and text versions), for example \"Ana García, [email protected]\". Left out: no Contact line."
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "A contact e-mail for this party. Used for the Contact line when contact is left out. The API key's account e-mail is never written into the contract."
        }
      },
      "required": [
        "legalName"
      ]
    },
    "counterparty": {
      "type": "object",
      "description": "The other side, with its address and jurisdiction of incorporation when you know them. Left out: its block stays blank for it to complete.",
      "properties": {
        "legalName": {
          "type": "string",
          "description": "Full legal name of the company or person. Printed as the party's name in the preamble, the Parties section and the signature block."
        },
        "address": {
          "type": "string",
          "description": "Registered office or principal place of business, for example \"Calle Mayor 1, 28013 Madrid, Spain\". Printed in the preamble (\"with its principal place of business at ...\") and the Parties section. Left out: [Address] stays as a blank to fill in."
        },
        "jurisdiction": {
          "type": "string",
          "description": "Where the party is incorporated or registered, for example \"Spain\" or \"Delaware, United States\". Printed in the Parties section of the Markdown, HTML and text versions."
        },
        "taxId": {
          "type": "string",
          "description": "Company or tax number (for example a Spanish NIF or a US EIN). Printed in the Parties section of the Markdown, HTML and text versions, and in the preamble where the template shows one."
        },
        "signatoryName": {
          "type": "string",
          "description": "Name of the person who signs. Printed in the signature block; left out, the Name line stays blank."
        },
        "signatoryTitle": {
          "type": "string",
          "description": "Title of the person who signs, for example CEO. Printed in the signature block; left out, the Title line stays blank."
        },
        "contact": {
          "type": "string",
          "description": "Contact person or details for the Contact line of the Parties section (Markdown, HTML and text versions), for example \"Ana García, [email protected]\". Left out: no Contact line."
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "A contact e-mail for this party. Used for the Contact line when contact is left out. The API key's account e-mail is never written into the contract."
        }
      },
      "required": [
        "legalName"
      ]
    },
    "role": {
      "type": "string",
      "description": "DPA and BAA only: the role you take (see roles in list_contract_types)"
    },
    "terms": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Inputs by id (see inputs in list_contract_types). Send every required input in terms. A required input with a default can be left out: the default is applied."
    },
    "clauses": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Optional clause choices: clause id to option code (see get_template)"
    },
    "inline": {
      "type": "string",
      "enum": [
        "md",
        "html",
        "txt"
      ],
      "default": "md",
      "description": "The contract itself in the answer: md (Markdown, the default here), html or txt"
    },
    "idempotencyKey": {
      "type": "string",
      "description": "Send the same value when retrying, so a retry never makes or charges a second contract"
    }
  },
  "required": [
    "contractType",
    "party"
  ]
}

List available contract templates with clauses, options, and bias values. Use this to understand which contract types are available and what options exist for each clause. Pass `query` to search by code, abbreviation or name in English or Spanish ("nda", "dpa", "hipaa", "confidencialidad"), best match first.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional search: contract code, abbreviation or name (English or Spanish)"
    }
  },
  "required": []
}

Get full details for a specific contract template including all clauses and their options with bias values.

{
  "type": "object",
  "properties": {
    "contractType": {
      "type": "string",
      "description": "Contract type code: one from list_contract_types, or an A2A_ agent-to-agent protocol type from list_templates (those are negotiated only, never made with generate_contract)"
    }
  },
  "required": [
    "contractType"
  ]
}

Create a negotiation playbook defining preferences for each clause: preferred option, priority (1-5), flexibility (1-5), red lines, and acceptable alternatives.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Unique playbook name"
    },
    "contractType": {
      "type": "string",
      "description": "Contract type code: one from list_contract_types, or an A2A_ agent-to-agent protocol type from list_templates (those are negotiated only, never made with generate_contract)"
    },
    "governingLaw": {
      "type": "string",
      "enum": [
        "CALIFORNIA",
        "ENGLAND_WALES",
        "SPAIN",
        "DELAWARE"
      ]
    },
    "contractLanguage": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en"
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "clauseId": {
            "type": "string"
          },
          "preferredOptionId": {
            "type": "string"
          },
          "priority": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          },
          "flexibility": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          },
          "isRedLine": {
            "type": "boolean"
          },
          "acceptableOptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "clauseId",
          "preferredOptionId"
        ]
      }
    }
  },
  "required": [
    "name",
    "contractType",
    "governingLaw",
    "entries"
  ]
}

Start a new contract negotiation. Returns a negotiation token for the respondent to join.

{
  "type": "object",
  "properties": {
    "playbookId": {
      "type": "string",
      "description": "ID of your playbook"
    },
    "dealName": {
      "type": "string",
      "description": "Human-readable deal name"
    },
    "initiatorEmail": {
      "type": "string",
      "format": "email"
    },
    "initiatorCompany": {
      "type": "string"
    },
    "respondentEmail": {
      "type": "string",
      "format": "email"
    },
    "respondentCompany": {
      "type": "string"
    }
  },
  "required": [
    "playbookId",
    "dealName",
    "initiatorEmail"
  ]
}

Join an existing negotiation as the respondent. Triggers automatic compromise resolution and returns the result.

{
  "type": "object",
  "properties": {
    "negotiationToken": {
      "type": "string",
      "description": "Token from the initiator"
    },
    "playbookId": {
      "type": "string",
      "description": "ID of your playbook (must match contract type)"
    },
    "respondentEmail": {
      "type": "string",
      "format": "email"
    },
    "respondentCompany": {
      "type": "string"
    }
  },
  "required": [
    "negotiationToken",
    "playbookId",
    "respondentEmail"
  ]
}

Get deal details including per-clause agreed options, satisfaction scores, and reasoning.

{
  "type": "object",
  "properties": {
    "dealId": {
      "type": "string",
      "description": "Agent deal room ID"
    }
  },
  "required": [
    "dealId"
  ]
}

Download the agreed contract as Markdown, HTML, PDF, DOCX or TXT (Markdown by default: agents read it best). Negotiation is free; the contract is paid when its document is first fetched: one prepaid credit of the customer is spent (any of its keys draws on the one balance). Later fetches of the same deal are free. With no credit left the answer is HTTP 402 with code PAYMENT_REQUIRED and the link to buy credits.

{
  "type": "object",
  "properties": {
    "dealId": {
      "type": "string",
      "description": "Agent deal room ID"
    },
    "format": {
      "type": "string",
      "enum": [
        "pdf",
        "docx",
        "txt",
        "md",
        "html"
      ],
      "default": "md",
      "description": "md (Markdown) or html for agents and tools; pdf, docx or txt for people and printers"
    }
  },
  "required": [
    "dealId"
  ]
}

Delete one of your single-party deals and its data: the parties, the other side's details, the clause choices, the inputs and the contract (documents are made on request and never stored). This cannot be undone. Only the account that made the deal can delete it; for any other account it does not exist (HTTP 404, also when it was already deleted). A deal another party takes part in, such as a two-party negotiation, is refused with HTTP 409 and nothing is deleted. The payment record is kept for billing (amount, date, account and deal id, no names or contract text), and a spent credit is not given back.

{
  "type": "object",
  "properties": {
    "dealId": {
      "type": "string",
      "description": "Agent deal id (dealId from generate_contract)"
    }
  },
  "required": [
    "dealId"
  ]
}

Open a hosted checkout for a pack of ten contract credits for this API key's customer (any of its keys can spend them). Returns checkoutUrl for a person to open in a browser; the credits arrive when the payment succeeds. Answers 409 where payments are off.

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur"
      ],
      "default": "usd"
    },
    "returnUrl": {
      "type": "string",
      "description": "URL to return to after checkout"
    }
  },
  "required": []
}

Remaining contract credits of this API key's customer (one balance shared by all of its keys) and the latest ledger entries.

{
  "type": "object",
  "properties": {},
  "required": []
}

List earlier per-skill subscriptions and their status. Skills are no longer sold one by one; every template is included.

{
  "type": "object",
  "properties": {},
  "required": []
}

Describe the matter in your own words; Dealroom answers with the contract types whose names or usual terms appear in the description (code, title, guide link), or "No template covers this. Such matters are usually handled by a lawyer." The matching is by words, with no AI model. A lawsuit or claim received, a subpoena, a data breach or a letter from a regulator is flagged as a time-sensitive matter outside the templates (outsideTemplates). It does not say what the user needs and names no lawyer. Free; no API key needed.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 500,
      "description": "The matter in plain words, in English or Spanish"
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en",
      "description": "Language of titles, links and the message"
    }
  },
  "required": [
    "query"
  ]
}

The options of one clause, each with its description and its pros and cons for each party, plus the clause's trade-off text, exactly as the template holds them. Nothing is ranked or recommended; when the template has no such text, the answer says so. Free (no credit).

{
  "type": "object",
  "properties": {
    "contractType": {
      "type": "string",
      "description": "Contract type code: one from list_contract_types, or an A2A_ agent-to-agent protocol type from list_templates (those are negotiated only, never made with generate_contract)"
    },
    "clause": {
      "type": "string",
      "description": "Clause id (from get_template) or the clause title"
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en"
    }
  },
  "required": [
    "contractType",
    "clause"
  ]
}

What a contract commits its parties to and the dates it states: the obligations ledger (recurring and event-driven duties, for the DPA today) and, for every contract type, the date inputs, the term, notice and renewal inputs and the agreed option of each term, renewal, termination, notice or duration clause. Facts as the contract states them; the contract text governs. Free (no credit).

{
  "type": "object",
  "properties": {
    "dealId": {
      "type": "string",
      "description": "Agent deal id (dealId from generate_contract)"
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en"
    }
  },
  "required": [
    "dealId"
  ]
}

A small public calendar of statutory dates: the Section 83(b) election (30 days after the stock is transferred), the SEC Form D notice (15 calendar days after the first sale) and the Delaware annual report and franchise tax (1 March). Give grantDate or firstSaleDate to count the due date. Each item carries its official source and is marked "Verify with the official source." General public dates, not advice. Free; no API key needed.

{
  "type": "object",
  "properties": {
    "grantDate": {
      "type": "string",
      "format": "date",
      "description": "Date the stock was transferred or granted (YYYY-MM-DD), for the 83(b) election"
    },
    "firstSaleDate": {
      "type": "string",
      "format": "date",
      "description": "Date of the first sale of securities (YYYY-MM-DD), for Form D"
    },
    "year": {
      "type": "integer",
      "description": "Year of the Delaware due date; left out, the next 1 March"
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "default": "en"
    }
  },
  "required": []
}

Invite a lawyer of the user's choice, by e-mail, to review the contract in Dealroom's attorney review. Available to any lawyer the user invites. The lawyer works for the user and bills the user directly; Dealroom takes no fee and makes no recommendation. Signing waits until the lawyer approves or the user cancels the review in Dealroom. Free (no credit).

{
  "type": "object",
  "properties": {
    "dealId": {
      "type": "string",
      "description": "Agent deal id (dealId from generate_contract)"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The lawyer's e-mail address"
    },
    "name": {
      "type": "string",
      "description": "The lawyer's name, for the e-mail greeting"
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "description": "Language of the e-mail; left out, the contract's language"
    }
  },
  "required": [
    "dealId",
    "email"
  ]
}