PharmaDocs AI API

The PharmaDocs AI REST API lets you integrate pharmaceutical document generation into your LIMS, ERP, or custom workflows. Authenticate with an API key and access your projects and documents programmatically.

Base URL

https://pharmadocsai.com

Authentication

Bearer Token (API Key)

Format

JSON (UTF-8)

Availability: API access is available on the Pro and Enterprise plans. Upgrade your plan to generate API keys.

Authentication

All API requests must include an Authorization header with a Bearer token. Generate your API key from the API Keys section of your dashboard.

Request Header

Authorization: Bearer sk_pd_your_api_key_here

Example cURL Request

curl -X GET "https://pharmadocsai.com/api/v1/projects" \
  -H "Authorization: Bearer sk_pd_your_api_key_here" \
  -H "Content-Type: application/json"

API keys are prefixed with sk_pd_ and are tied to a specific company account. Keep your key secret — treat it like a password. Revoke and regenerate it from your dashboard if compromised.

Error Codes

All errors return a JSON body with a { "success": false, "error": "message" } shape.

HTTP Status	Meaning
200 OK	Request succeeded
201 Created	Resource created successfully
400 Bad Request	Missing or invalid parameters in the request body
401 Unauthorized	Missing or invalid API key
403 Forbidden	API key is valid but lacks permission (plan restriction)
404 Not Found	Resource does not exist or belongs to a different account
422 Unprocessable	Extracted data missing — run AI extraction in dashboard first
429 Too Many Requests	Rate limit exceeded
500 Internal Error	Server-side error — retry or contact support

Rate Limits

Plan	Limit	Window
Pro	500 requests	Per day
Enterprise	Unlimited	Per contract

Endpoints

All endpoints require a valid API key passed as a Bearer token.

GET/api/v1/projectsAuth Required

List all projects belonging to your account.

Parameters

Name	Type	In	Description
page	integer	query	Page number (default: 1)
limit	integer	query	Items per page, max 100 (default: 20)

Response Body (200)

{
  "success": true,
  "data": [
    {
      "id": 1042,
      "product_name": "Paracetamol 500mg",
      "product_id": "uuid",
      "project_type": "amv",
      "status": "completed",
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "meta": { "total": 42, "page": 1, "limit": 20, "pages": 3 }
}

GET/api/v1/projects/{id}Auth Required

Get a single project with its AI-extracted fields and list of generated documents.

Parameters

Name	Type	In	Description
id	integer	path	Project ID returned from List Projects

Response Body (200)

{
  "success": true,
  "data": {
    "id": 1042,
    "product_name": "Paracetamol 500mg",
    "status": "completed",
    "created_at": "2026-01-15T10:30:00Z",
    "extracted_fields": {
      "product_name": "Paracetamol 500mg",
      "method_of_analysis": "HPLC",
      "specification": "99.0 – 101.0%",
      "wavelength": "243 nm",
      "column": "C18, 250 x 4.6 mm"
    },
    "documents": [
      {
        "id": 88,
        "doc_type": "AMV_PROTOCOL",
        "file_name": "AMV_PROTOCOL_Paracetamol_500mg_1705312200.docx",
        "generated_at": "2026-01-15T11:00:00Z"
      }
    ]
  }
}

GET/api/v1/documentsAuth Required

List generated documents. Optionally filter by project or document type.

Parameters

Name	Type	In	Description
project_id	integer	query	Filter by project ID
doc_type	string	query	Filter by type: AMV_PROTOCOL, AMV_REPORT, etc.
page	integer	query	Page number (default: 1)
limit	integer	query	Items per page, max 100 (default: 20)

Response Body (200)

{
  "success": true,
  "data": [
    {
      "id": 88,
      "project_id": 1042,
      "doc_type": "AMV_PROTOCOL",
      "file_name": "AMV_PROTOCOL_Paracetamol_500mg_1705312200.docx",
      "file_url": "https://res.cloudinary.com/.../document.docx",
      "generated_at": "2026-01-15T11:00:00Z"
    }
  ],
  "meta": { "total": 15, "page": 1, "limit": 20, "pages": 1 }
}

POST/api/v1/generateAuth Required

Trigger document generation for an existing project. The project must have AI-extracted data. Returns the generated document URL.

Parameters

Name	Type	In	Description
project_id	integer	body	ID of the project to generate from
doc_type	string	body	amv-protocol \| amv-report \| amv-rs-protocol \| amv-rs-report \| pp-protocol \| pp-report \| stability-study \| force-degradation

Response Body (200)

{
  "success": true,
  "data": {
    "doc_type": "amv-protocol",
    "project_id": 1042,
    "file_url": "https://res.cloudinary.com/.../AMV_Protocol.docx",
    "file_name": "AMV_PROTOCOL_Paracetamol_500mg_1705315200.docx",
    "generated_at": "2026-01-15T12:00:00Z"
  },
  "message": "Document generated successfully."
}

Supported Document Types

Use these values for the doc_type field in the Generate endpoint.

Value	Name	Description
amv-protocol	AMV Protocol	Analytical Method Validation Protocol
amv-report	AMV Report	Analytical Method Validation Report
amv-rs-protocol	AMV RS Protocol	Related Substances AMV Protocol
amv-rs-report	AMV RS Report	Related Substances AMV Report
pp-protocol	PP Protocol	Process Validation Protocol
pp-report	PP Report	Process Validation Report
stability-study	Stability Study	ICH Stability Study Document
force-degradation	Force Degradation	Stress Testing / Force Degradation Report

Need Help?

If you have questions about the API, encounter an unexpected error, or want to request a new feature, reach out to our team.

Email Support Open a Ticket