Skip to content
Paximal

API

Connect Paximal to Your Systems

Submit invention disclosures from your own tools with the intake API, and build agents on the MCP server.

Project Intake API

Create, Upload, Submit

Three requests turn a record in your idea portal or ticketing system into a Paximal matter with its documents attached, ready for an attorney.

Direct File Upload
Original files are uploaded to the matter using short-lived, narrowly scoped credentials.
Your Identifiers
Include an external ID and your own reference so both systems can find the matter.
Attorney-Initiated Work
The API handles intake only. An attorney decides what happens next.
Developer Guide and OpenAPI Specification

intake.sh

# 1. Create a project
curl -X POST https://next.paximal.com/api/v1/projects \
  -H "Authorization: Bearer $PAXIMAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "project_reference": "RX-2207",
        "invention_name": "Self-calibrating joint torque sensor",
        "inventors": ["Dana Whitlock", "Priya Raman"],
        "entity_name": "Northfield Robotics, Inc.",
        "entity_type": "company",
        "external_id": "IDEA-4471"
      }'

# 2. Upload the original documents using the
#    short-lived credentials in the response

# 3. Mark the project ready for the attorney
curl -X POST \
  https://next.paximal.com/api/v1/projects/$PROJECT_ID/submit \
  -H "Authorization: Bearer $PAXIMAL_API_KEY"

Intake

Matters Arrive Where Attorneys Work

A submitted project appears in the attorney's workspace at the first step, the same as a matter created in the web app or through an AI assistant.

MCP Server

Build Agents on the Same Tools

The MCP server exposes every step of the workflow with explicit step, source and revision arguments. Requests are safe to retry, and original files are transferred directly.

View the MCP Tools
PaximalConnected to your assistant

Design review

Drift study

Calibration notes

Start a matter from these files. Run novelty and detectability, then draft a utility application.

Matter RX-2207 is open with your three documents.

  • Invention disclosureComplete
  • Novelty analysisRunning
  • Detectability analysisRunning
  • Application draftStarts when analyses finish

Does anything need my input?

One decision. Which should be the first independent claim?

Apparatus claim

A robotic joint assembly comprising a torque sensor and a controller…

Method claim

A method of calibrating a joint torque sensor, comprising…

Use the apparatus claim. Send me the draft once it is proofread.

Revision 2 is ready for your review.

Specification

Clean copy

Redline

Against Rev 1

Proofreading report

2 items for you

Frequently Asked Questions

Have another question? Email info@paximal.com.

  • Does submitting a project start any drafting?
    No. The API creates the matter and attaches the documents. No drafting starts and no credits are used until an attorney starts a step in Paximal.
  • How are API keys scoped?
    Each key belongs to one user and one organization. Revoking a key blocks further requests immediately.
  • How do we avoid duplicate projects on retry?
    Send your own project reference. A repeated reference returns a conflict response that includes the existing project ID.
  • Are there rate limits?
    Yes. Requests are limited per user and organization. A rate-limited response includes a Retry-After header, and every response includes a request ID.
  • How do we get access?
    The intake API is enabled per organization. Contact us and we will enable it and share the developer guide.

Planning an Integration?

Tell us what you want to connect. We will enable the API for your organization and help with the first matter.