How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

YouSign Signature Request API

Process of inviting Signers to sign a Document.

YouSign Signature Request API is one of 38 APIs that YouSign publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Signature Request. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a changelog, rate-limit docs, and 1 JSON Schema.

This API exposes 8 operations across 5 paths, and defines 74 schemas. It is described by OpenAPI 3.2.0, at version 3.0.

Requests are made against 2 base URLs: https://api-sandbox.yousign.app/v3, https://api.yousign.app/v3.

8 operations 5 paths 74 schemas 1 DELETE2 GET1 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.0
Base URL
https://api.yousign.com/v3
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

YouSign Signature Request API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 2 GET, 1 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Signature Request 8

Process of inviting Signers to sign a Document.

GET
/signature_requests
List Signature Requests
get-signature_requests 14 params → 200400401403405429500
POST
/signature_requests
Initiate a new Signature Request
post-signature_requests body → 201400401403404405415429
DELETE
/signature_requests/{signatureRequestId}
Delete a Signature Request
delete-signature_requests-signatureRequestId 2 params → 204400401403404405429500
GET
/signature_requests/{signatureRequestId}
Fetch a Signature Request
get-signature_requests-signatureRequestId 1 param → 200400401403404405429500
PATCH
/signature_requests/{signatureRequestId}
Update a Signature Request
patch-signature_requests-signatureRequestId 1 param body → 200400401403404405415429
POST
/signature_requests/{signatureRequestId}/activate
Activate a Signature Request
post-signature_requests-signatureRequestId-activate 1 param body → 201400401403404405429500
POST
/signature_requests/{signatureRequestId}/cancel
Cancel a Signature Request
post-signature_requests-signatureRequestId-cancel 1 param body → 201400401403404405415429
POST
/signature_requests/{signatureRequestId}/reactivate
Reactivate an expired Signature Request
post-signature_requests-signatureRequestId-reactivate 1 param body → 201400401403404405415429

Schemas 74

The contract defines 74 schemas that model the data the API accepts and returns. The most detailed are SignatureRequest (34 properties), SignatureRequestInList (31 properties), SignatureRequestActivated (27 properties), New_Signature_Request_From_Scratch (24 properties). Each schema is shown below with its type and property counts.

WorkflowSessionId
stringnull
Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
SignatureRequestTimeZone
string
Time zone of the dates and times displayed in emails, the Signature Request expiration date, and the PDF Audit Trail. Format: tz database. Default is set to Eu…
PreviousAttemptId
stringnull
ID of the previous attempt within the same workflowsessionid. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.
UnauthorizedResponse
object
2 properties 2 required
FieldsInput
object
SignatureRequest_PlaceholderSignerSubstituteFromUserIdInput
object
Create a placeholder signer substitute from a user
7 properties 2 required
TooManyRequestsResponse
object
1 property 1 required
SignatureRequest_EmailNotification
objectnull
3 properties
New_Signature_Request_From_Scratch
object
Create a new Signature Request from scratch
24 properties 2 required
UUID
string
The unique identifier for a resource.
SignatureRequestInList
object
31 properties 27 required
Checkbox_2
object
11 properties 7 required
SignatureRequest_SignerFromContactIdInput
object
Create signer from a contact
7 properties 2 required
SignatureRequestInList_reminder_settings
objectnull
2 properties 2 required
SignatureRequest
object
34 properties 29 required
SignatureRequest_EmailNotification_Sender
object
2 properties
New_Signature_Request_From_Scratch_reminder_settings
objectnull
Enable automatic reminders for pending Signers.
2 properties 2 required
MethodNotAllowed
object
1 property 1 required
Locale
string
Locale settings used for communication.
CustomPropertyType
string
SignatureRequest_rejection_information
objectnull
Information related to the rejection of a Signature Request by an Approver.
3 properties
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput_info
object
Create new signer
5 properties 4 required
SignatureRequest_email_notification_sender
object
2 properties 2 required
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput
object
Create a placeholder signer substitute from info
7 properties 2 required
SignatureRequest_PlaceholderReadOnlyTextFieldSubstituteInput
object
Create a placeholder readonlytext field substitute
2 properties 2 required
UpdateSignatureRequest_reminder_settings
objectnull
2 properties 2 required
New_Signature_Request_From_Scratch_template_placeholders
objectnull
When creating a signature request from a template, all substituting data for placeholders defined in the given template.
2 properties
SignatureRequestActivated
object
27 properties 25 required
HumanName
string
CustomPropertyValue
object
6 properties 3 required
SignatureRequest_SignerFromInfoInput
object
Create a signer from info
7 properties 2 required
SignatureRequest_PlaceholderSignerSubstituteFromContactIdInput
object
Create a placeholder signer substitute from a contact
7 properties 2 required
SignatureRequestActivated_documents_inner
object
2 properties 2 required
New_Signature_Request_From_Scratch_signers_inner
Create signers
SignatureRequest_SignerFromInfoInput_info
object
create new signer
5 properties 4 required
get_signature_requests_200_response
object
2 properties
Pagination
object
Metadata about the response.
1 property 1 required
UpdateSignatureRequest
object
16 properties
CreateSignatureRequest
object
ActivateSignatureRequest
object
1 property
CustomPropertyOption
object
4 properties 4 required
SignatureRequestInList_documents_inner
object
2 properties 2 required
CustomPropertyInList
object
8 properties 3 required
ApproverToNotify
object
4 properties 4 required
AuditTrailLocale
string
Signature_2
object
8 properties 5 required
RadioGroup_2
object
7 properties 5 required
SignatureRequestStatus
string
RadioGroup_2_radios_inner
object
5 properties 2 required
SignerDeliveryMode
stringnull
Override the delivery mode of the Signature Request for this Signer
New_Signature_Request_From_Scratch_template_placeholders_signers_inner
SignatureRequest_email_notification
object
2 properties 2 required
SignatureRequestInList_signers_inner
object
2 properties 2 required
SignatureRequest_SignerFromInfoInput_redirect_urls
object
2 properties
post_signature_requests_signatureRequestId_cancel_request
object
2 properties 1 required
NotFoundResponse
object
2 properties 2 required
SignatureRequest_EmailNotification_custom_text
objectnull
4 properties
post_signature_requests_signatureRequestId_reactivate_request
object
1 property 1 required
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput_redirect_urls
object
3 properties
SignatureRequestInList_approvers_inner
object
2 properties 2 required
SignatureRequestLabel
object
2 properties 2 required
Mention_2
object
9 properties 6 required
ForbiddenResponse
object
2 properties 2 required
Text_2
object
14 properties 8 required
Duplicate_a_Signature_Request
object
Duplicate a Signature Request. It will be added to the same workspace as the original.
4 properties 1 required
InternalServerError
object
2 properties 2 required
SignatureRequestInList_sender
objectnull
2 properties
Archiving
stringnull
Once the signature request completed, archive its documents in a secure digital safe
SignatureRequest_SignerFromUserIdInput
object
Create a signer from a user
7 properties 2 required
EmbeddedSignerWithSignatureLink
object
4 properties 4 required
BadRequestResponse
object
2 properties 2 required
UnsupportedMediaTypeResponse
object
2 properties 2 required
SignatureRequest_SignerFromInfoInput_custom_text
object
4 properties
SignatureRequest_decline_information
objectnull
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yousign-signature-request-api-openapi.yml Raw ↑

Other APIs YouSign publishes across the network.

YouSign Applicant API
YouSign Approver API
YouSign Archive API
YouSign Audit Trail API
YouSign Bank Account Lookup Verification API
YouSign Bank Account Verification API
YouSign Company Verification API
YouSign Consumption API
YouSign Contact API
YouSign Custom Experience API
YouSign Custom Property API
YouSign Deprecated API
Where this information came from

This is an independent, third-party profile of YouSign Signature Request API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.