JuriSign

JuriSign REST API

Documented, versioned REST API (OpenAPI 3.0.3, 46 operations across 8 tags) for eIDAS SES electronic signatures: documents, sign requests, templates, bulk campaigns, public forms, account credits, webhooks and authentication. Bearer token auth with five restrictable scopes, an Idempotency-Key on sign-request creation, page-number pagination, and a free sandbox token flow that neutralises real delivery and billing while still firing webhooks.

GitHub OpenAPI

Operations 46

GET / API Status #
POST /auth/token Create API Token #
DELETE /auth/token Revoke Current Token #
POST /auth/sandbox-token Create Sandbox API Token #
GET /account/credits Get Credit Balance #
GET /templates List Sign Request Templates #
GET /templates/{id} Get Template #
DELETE /templates/{id} Delete Template #
POST /templates/{id}/sign-requests Create Sign Request From Template #
GET /bulk-templates List Bulk Templates #
POST /bulk-templates Create Bulk Template #
GET /bulk-templates/{id} Get Bulk Template #
PUT /bulk-templates/{id} Update Bulk Template #
DELETE /bulk-templates/{id} Delete Bulk Template #
GET /bulk-campaigns List Bulk Campaigns #
POST /bulk-campaigns Create Bulk Campaign #
GET /bulk-campaigns/{id} Get Bulk Campaign #
DELETE /bulk-campaigns/{id} Delete Bulk Campaign #
POST /bulk-campaigns/{id}/launch Launch Bulk Campaign #
POST /bulk-campaigns/{id}/cancel Cancel Bulk Campaign #
POST /bulk-campaigns/{id}/retry Retry Failed Recipients #
GET /bulk-campaigns/{id}/export Export Campaign Results #
GET /public-forms List Public Forms #
POST /public-forms Create Public Form #
GET /public-forms/{id} Get Public Form #
PUT /public-forms/{id} Update Public Form #
DELETE /public-forms/{id} Delete Public Form #
POST /public-forms/{id}/rotate-token Rotate Public Form Token #
GET /documents List Documents #
POST /documents Upload Document #
GET /documents/{id} Get Document #
DELETE /documents/{id} Delete Document #
GET /documents/{id}/download Download Document #
GET /sign-requests List Sign Requests #
POST /sign-requests Create Sign Request #
GET /sign-requests/{id} Get Sign Request #
POST /sign-requests/{id}/send Send Sign Request #
POST /sign-requests/{id}/cancel Cancel Sign Request #
GET /sign-requests/{id}/download Download Signed PDF #
GET /sign-requests/{id}/proof Download Audit Proof #
GET /webhooks List Webhook Endpoints #
POST /webhooks Create Webhook Endpoint #
PUT /webhooks/{id} Update Webhook Endpoint #
DELETE /webhooks/{id} Delete Webhook Endpoint #
GET /webhooks/{id}/logs Webhook Delivery Logs #
POST /webhooks/{id}/regenerate-secret Regenerate Webhook Secret #

Documentation

📖
Documentation
https://www.jurisign.fr/api/docs
📖
APIReference
https://www.jurisign.fr/api/swagger
📖
GettingStarted
https://www.jurisign.fr/api/guide

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/openapi/jurisign-api-openapi.yml
⚙
OpenAPI
https://www.jurisign.fr/api/openapi.json

Other Resources

🔗
DeveloperPortal
https://www.jurisign.fr/developpeurs
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/overlays/jurisign-api-overlay.yaml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/examples/jurisign-examples.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/data-model/jurisign-data-model.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jurisign-rest-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jurisign-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: JuriSign API
  description: 'Electronic signature API (eIDAS SES level) with OTP verification (email or SMS). Upload documents, create
    signature requests with multiple signers, and track the signing process via webhooks. Rate limits, per minute and per
    authenticated user: 60 regular calls, 20 document uploads, 30 send/cancel/relaunch actions, 30 webhook management calls.
    Authentication is limited to 10 attempts per minute for the targeted account, plus 60 per minute for the calling IP. Exceeding
    a limit returns 429 with a Retry-After header — wait for it rather than retrying immediately.'
  version: 3.24.1
  contact:
    name: JuriSign Support
    email: support@jurisign.fr
    url: https://jurisign.fr
  license:
    name: Proprietary
servers:
- url: https://jurisign.fr/api/v1
  description: Production (also serves sandbox requests — see POST /auth/sandbox-token)
security:
- bearerAuth: []
tags:
- name: Authentication
  description: Obtain and revoke API tokens
- name: Documents
  description: Upload and manage PDF documents
- name: Sign Requests
  description: Create, send, and track signature requests
- name: Templates
  description: Reusable sign request templates
- name: Bulk
  description: Merge templates and bulk campaigns (one individualised request per recipient)
- name: Public Forms
  description: 'Shareable links: each respondent signs their own generated request, no account needed'
- name: Account
  description: Credit balance and plan
- name: Webhooks
  description: Manage webhook endpoints for event notifications
paths:
  /:
    get:
      summary: API Status
      description: Returns the current API status and version information.
      operationId: getStatus
      security: []
      tags:
      - Authentication
      responses:
        '200':
          description: API is operational
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                    example: JuriSign API
                  version:
                    type: string
                    example: '3.2'
                  status:
                    type: string
                    example: ok
                  docs:
                    type: string
                    example: https://jurisign.fr/api/docs
  /auth/token:
    post:
      summary: Create API Token
      description: Authenticate with email/password to obtain a Bearer token, scoped to your organization. By default the
        token is granted all 5 available scopes (documents:read, documents:write, sign-requests:read, sign-requests:write,
        webhooks:manage). Pass `scopes` to request a restricted subset instead — every endpoint checks the token's abilities
        and returns 403 if the required scope is missing. Rate limited to 10 attempts per minute for the targeted account,
        and 60 per minute for the calling IP.
      operationId: createToken
      security: []
      tags:
      - Authentication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                  example: user@example.com
                  description: Your account email address
                password:
                  type: string
                  format: password
                  example: your-password
                  description: Your account password
                device_name:
                  type: string
                  maxLength: 100
                  example: my-app
                  description: Optional device identifier. Tokens with the same device name will be revoked and replaced.
                scopes:
                  type: array
                  items:
                    type: string
                    enum:
                    - documents:read
                    - documents:write
                    - sign-requests:read
                    - sign-requests:write
                    - webhooks:manage
                  example:
                  - documents:read
                  - sign-requests:write
                  description: Optional. Restricts the token to the given scopes. `sign-requests:read` / `sign-requests:write`
                    also cover the templates and bulk-* endpoints. Omit to receive all 5 scopes (default, unchanged behavior
                    for existing integrations).
      responses:
        '200':
          description: Token created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: string
                    example: 1|abc123...
                  token_type:
                    type: string
                    example: Bearer
                  user:
                    $ref: '#/components/schemas/AuthUser'
        '403':
          description: Account not in an organization or organization suspended
          $ref: '#/components/responses/Error'
        '422':
          description: Invalid credentials or validation error
          $ref: '#/components/responses/ValidationError'
        '429':
          description: Rate limit exceeded (10 attempts/minute for the targeted account, 60/minute for the calling IP) — see
            the Retry-After header
          $ref: '#/components/responses/Error'
    delete:
      summary: Revoke Current Token
      description: Revoke the Bearer token used in this request.
      operationId: revokeToken
      tags:
      - Authentication
      responses:
        '200':
          description: Token revoked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
  /auth/sandbox-token:
    post:
      summary: Create Sandbox API Token
      description: 'Authenticate with the same email/password as POST /auth/token, but obtain a sandbox token instead (prefixed
        sandbox_...). Requests made with this token never send real SMS or emails (SMS are logged, emails go through the log
        mailer) and never deduct signature credits. Documents and signature requests created in sandbox mode are isolated
        from your organization''s real data: they never appear in a normal (non-sandbox) request, and vice versa. A sandbox
        token can only be used with the sandbox_ prefix, and a normal token can never be used with it — mixing the two returns
        401. Rate limited to 10 attempts per minute for the targeted account, and 60 per minute for the calling IP.'
      operationId: createSandboxToken
      security: []
      tags:
      - Authentication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              - password
              properties:
                email:
                  type: string
                  format: email
                  example: user@example.com
                  description: Your account email address
                password:
                  type: string
                  format: password
                  example: your-password
                  description: Your account password
                device_name:
                  type: string
                  maxLength: 100
                  example: my-app-sandbox
                  description: Optional device identifier. Tokens with the same device name will be revoked and replaced.
      responses:
        '200':
          description: Sandbox token created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  token:
                    type: string
                    example: sandbox_1|abc123...
                  token_type:
                    type: string
                    example: Bearer
                  sandbox:
                    type: boolean
                    example: true
                  user:
                    $ref: '#/components/schemas/AuthUser'
        '403':
          description: Account not in an organization or organization suspended
          $ref: '#/components/responses/Error'
        '422':
          description: Invalid credentials or validation error
          $ref: '#/components/responses/ValidationError'
        '429':
          description: Rate limit exceeded (10 attempts/minute for the targeted account, 60/minute for the calling IP) — see
            the Retry-After header
          $ref: '#/components/responses/Error'
  /account/credits:
    get:
      summary: Get Credit Balance
      description: Retrieve your organization's real-time signature credit consumption. Scoped strictly to the organization
        of the authenticated token.
      operationId: getAccountCredits
      tags:
      - Account
      responses:
        '200':
          description: Credit balance
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      plan:
                        type: string
                        example: equipe
                      credits_total:
                        type: integer
                        example: 100
                      credits_used:
                        type: integer
                        example: 41
                      credits_remaining:
                        type: integer
                        example: 59
                        description: Never negative, even if usage exceeds the plan.
                      trial_ends_at:
                        type: string
                        format: date-time
                        nullable: true
        '401':
          $ref: '#/components/responses/Unauthenticated'
  /templates:
    get:
      summary: List Sign Request Templates
      description: Retrieve reusable sign request templates for your organization.
      operationId: listTemplates
      tags:
      - Templates
      parameters:
      - name: per_page
        in: query
        schema:
          type: integer
          default: 20
      - name: page
        in: query
        schema:
          type: integer
          default: 1
      responses:
        '200':
          description: Templates list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Template'
                  meta:
                    $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthenticated'
  /templates/{id}:
    get:
      summary: Get Template
      description: Retrieve full details of a template, including signers and signature zones.
      operationId: getTemplate
      tags:
      - Templates
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Template details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/TemplateDetailed'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Delete Template
      description: Delete a template and its own copy of the PDF, if any.
      operationId: deleteTemplate
      tags:
      - Templates
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Template deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
  /templates/{id}/sign-requests:
    post:
      summary: Create Sign Request From Template
      description: Create a signature request from a template, reusing its signers, signature zones, and (if present) its
        own copy of the document. Subject, message, expiry and redirect_url can be overridden. If the template has no document
        of its own, `document_id` is required.
      operationId: createSignRequestFromTemplate
      tags:
      - Templates
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                subject:
                  type: string
                  maxLength: 255
                message:
                  type: string
                  maxLength: 2000
                  nullable: true
                metadata:
                  type: object
                  nullable: true
                expiry_hours:
                  type: integer
                  minimum: 1
                  maximum: 720
                auto_send:
                  type: boolean
                redirect_url:
                  type: string
                  format: uri
                  maxLength: 2048
                document_id:
                  type: string
                  format: uuid
                  description: Required only if the template has no document of its own
      responses:
        '201':
          description: Sign request created from template
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/SignRequest'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/ValidationError'
  /bulk-templates:
    get:
      summary: List Bulk Templates
      description: Retrieve reusable merge-field HTML templates used by bulk campaigns.
      operationId: listBulkTemplates
      tags:
      - Bulk
      responses:
        '200':
          description: Bulk templates list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/BulkTemplate'
                  meta:
                    $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthenticated'
    post:
      summary: Create Bulk Template
      description: Create a merge-field HTML template (e.g. `<p>Bonjour {{prenom}} {{nom}}</p>`). Merge fields are auto-extracted
        from the content.
      operationId: createBulkTemplate
      tags:
      - Bulk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - html_content
              properties:
                name:
                  type: string
                  maxLength: 255
                description:
                  type: string
                  maxLength: 1000
                  nullable: true
                html_content:
                  type: string
                  description: HTML with {{field}} placeholders
      responses:
        '201':
          description: Bulk template created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkTemplate'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '422':
          $ref: '#/components/responses/ValidationError'
  /bulk-templates/{id}:
    get:
      summary: Get Bulk Template
      operationId: getBulkTemplate
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Bulk template details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkTemplate'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      summary: Update Bulk Template
      operationId: updateBulkTemplate
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                description:
                  type: string
                  nullable: true
                html_content:
                  type: string
      responses:
        '200':
          description: Bulk template updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkTemplate'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Delete Bulk Template
      description: Fails with 422 if the template is still referenced by a campaign.
      operationId: deleteBulkTemplate
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Bulk template deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Error'
  /bulk-campaigns:
    get:
      summary: List Bulk Campaigns
      operationId: listBulkCampaigns
      tags:
      - Bulk
      parameters:
      - name: status
        in: query
        schema:
          type: string
      - name: per_page
        in: query
        schema:
          type: integer
          default: 20
      responses:
        '200':
          description: Bulk campaigns list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/BulkCampaign'
                  meta:
                    $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthenticated'
    post:
      summary: Create Bulk Campaign
      description: Create a bulk campaign with recipients provided directly as JSON (no Excel upload needed for API clients).
        Each recipient generates one individualized sign request, merged from the bulk template. Invalid rows (missing fields,
        invalid email, duplicate email) are skipped and reported in `skipped_recipients`, not fatal.
      operationId: createBulkCampaign
      tags:
      - Bulk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - bulk_template_id
              - expiry_hours
              - otp_channel
              - recipients
              properties:
                name:
                  type: string
                  maxLength: 255
                bulk_template_id:
                  type: string
                  format: uuid
                expiry_hours:
                  type: integer
                  minimum: 1
                  maximum: 720
                otp_channel:
                  type: string
                  enum:
                  - sms
                  - email
                message:
                  type: string
                  maxLength: 2000
                  nullable: true
                require_selfie:
                  type: boolean
                recipients:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    required:
                    - nom
                    - prenom
                    - email
                    properties:
                      nom:
                        type: string
                      prenom:
                        type: string
                      email:
                        type: string
                        format: email
                      telephone:
                        type: string
                        nullable: true
                      adresse:
                        type: string
                        nullable: true
                    description: Extra keys are accepted and become available as {{merge fields}} in the bulk template.
      responses:
        '201':
          description: Campaign created (draft, not yet launched)
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkCampaign'
                  skipped_recipients:
                    type: integer
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '422':
          $ref: '#/components/responses/ValidationError'
  /bulk-campaigns/{id}:
    get:
      summary: Get Bulk Campaign
      operationId: getBulkCampaign
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Bulk campaign details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkCampaign'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Delete Bulk Campaign
      description: Fails with 422 if the campaign is currently processing.
      operationId: deleteBulkCampaign
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Bulk campaign deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Error'
  /bulk-campaigns/{id}/launch:
    post:
      summary: Launch Bulk Campaign
      description: Dispatches an asynchronous job that generates each recipient's document, creates their sign request, and
        sends it. Fails with 422 if the organization does not have enough remaining credits.
      operationId: launchBulkCampaign
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: 'Campaign launched (status: processing)'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkCampaign'
                  message:
                    type: string
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Error'
  /bulk-campaigns/{id}/cancel:
    post:
      summary: Cancel Bulk Campaign
      operationId: cancelBulkCampaign
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Campaign cancelled
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkCampaign'
                  message:
                    type: string
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Error'
  /bulk-campaigns/{id}/retry:
    post:
      summary: Retry Failed Recipients
      description: Resets recipients in error back to pending so the campaign can be launched again.
      operationId: retryBulkCampaign
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Failed recipients reset
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BulkCampaign'
                  message:
                    type: string
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/Error'
  /bulk-campaigns/{id}/export:
    get:
      summary: Export Campaign Results
      description: Per-recipient status, send/sign timestamps, and error messages.
      operationId: exportBulkCampaignResults
      tags:
      - Bulk
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Recipient results
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        nom:
                          type: string
                        prenom:
                          type: string
                        email:
                          type: string
                        telephone:
                          type: string
                          nullable: true
                        status:
                          type: string
                        sent_at:
                          type: string
                          format: date-time
                          nullable: true
                        signed_at:
                          type: string
                          format: date-time
                          nullable: true
                        error_message:
                          type: string
                          nullable: true
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
  /public-forms:
    get:
      summary: List Public Forms
      description: Retrieve the shareable public forms (PowerForms) of your organization.
      operationId: listPublicForms
      tags:
      - Public Forms
      parameters:
      - name: per_page
        in: query
        schema:
          type: integer
          default: 20
      responses:
        '200':
          description: Public forms list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicForm'
                  meta:
                    $ref: '#/components/schemas/Pagination'
        '401':
          $ref: '#/components/responses/Unauthenticated'
    post:
      summary: Create Public Form
      description: Publish a shareable link backed by one of your sign request templates. Anyone opening the link fills in
        their details and becomes the signer of their own signature request, generated on the fly. The template MUST have
        exactly one signer and its own copy of the PDF.
      operationId: createPublicForm
      tags:
      - Public Forms
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - sign_request_template_id
              properties:
                name:
                  type: string
                  maxLength: 255
                sign_request_template_id:
                  type: string
                  format: uuid
                  description: Template with exactly 1 signer and its own document
                expires_at:
                  type: string
                  format: date-time
                  nullable: true
                daily_submission_limit:
                  type: integer
                  minimum: 1
                  nullable: true
                  description: Anti-abuse cap; clamped to the platform maximum
      responses:
        '201':
          description: Public form created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PublicForm'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '422':
          $ref: '#/components/responses/ValidationError'
  /public-forms/{id}:
    get:
      summary: Get Public Form
      operationId: getPublicForm
      tags:
      - Public Forms
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Public form details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PublicForm'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    put:
      summary: Update Public Form
      description: Rename, pause/reactivate, change the expiry or the daily cap.
      operationId: updatePublicForm
      tags:
      - Public Forms
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                status:
                  type: string
                  enum:
                  - active
                  - paused
                expires_at:
                  type: string
                  format: date-time
                  nullable: true
                daily_submission_limit:
                  type: integer
                  nullable: true
      responses:
        '200':
          description: Public form updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PublicForm'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      summary: Delete Public Form
      operationId: deletePublicForm
      tags:
      - Public Forms
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      responses:
        '200':
          description: Public form deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
        '401':
          $ref: '#/components/responses/

# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jurisign/refs/heads/main/openapi/jurisign-api-openapi.yml