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.

CustomPropertyValue
object
6 properties 3 required
Text_2
object
14 properties 8 required
SignatureRequest_email_notification
object
2 properties 2 required
SignatureRequest_decline_information
objectnull
3 properties
UUID
string
The unique identifier for a resource.
ForbiddenResponse
object
2 properties 2 required
SignatureRequest
object
34 properties 29 required
NotFoundResponse
object
2 properties 2 required
Archiving
stringnull
Once the signature request completed, archive its documents in a secure digital safe
SignatureRequest_email_notification_sender
object
2 properties 2 required
New_Signature_Request_From_Scratch_signers_inner
Create signers
CustomPropertyInList
object
8 properties 3 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
Signature_2
object
8 properties 5 required
Locale
string
Locale settings used for communication.
post_signature_requests_signatureRequestId_reactivate_request
object
1 property 1 required
Pagination
object
Metadata about the response.
1 property 1 required
SignatureRequest_EmailNotification_custom_text
objectnull
4 properties
post_signature_requests_signatureRequestId_cancel_request
object
2 properties 1 required
SignatureRequest_EmailNotification_Sender
object
2 properties
ApproverToNotify
object
4 properties 4 required
get_signature_requests_200_response
object
2 properties
CustomPropertyOption
object
4 properties 4 required
SignatureRequest_SignerFromInfoInput_redirect_urls
object
2 properties
SignatureRequestActivated
object
27 properties 25 required
SignatureRequest_PlaceholderSignerSubstituteFromContactIdInput
object
Create a placeholder signer substitute from a contact
7 properties 2 required
SignatureRequest_PlaceholderSignerSubstituteFromUserIdInput
object
Create a placeholder signer substitute from a user
7 properties 2 required
CreateSignatureRequest
object
SignatureRequest_EmailNotification
objectnull
3 properties
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput
object
Create a placeholder signer substitute from info
7 properties 2 required
RadioGroup_2
object
7 properties 5 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
Checkbox_2
object
11 properties 7 required
EmbeddedSignerWithSignatureLink
object
4 properties 4 required
SignatureRequestInList
object
31 properties 27 required
CustomPropertyType
string
AuditTrailLocale
string
UnauthorizedResponse
object
2 properties 2 required
New_Signature_Request_From_Scratch
object
Create a new Signature Request from scratch
24 properties 2 required
ActivateSignatureRequest
object
1 property
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput_redirect_urls
object
3 properties
SignatureRequestInList_reminder_settings
objectnull
2 properties 2 required
MethodNotAllowed
object
1 property 1 required
New_Signature_Request_From_Scratch_reminder_settings
objectnull
Enable automatic reminders for pending Signers.
2 properties 2 required
RadioGroup_2_radios_inner
object
5 properties 2 required
SignatureRequest_rejection_information
objectnull
Information related to the rejection of a Signature Request by an Approver.
3 properties
UpdateSignatureRequest_reminder_settings
objectnull
2 properties 2 required
FieldsInput
object
SignatureRequest_SignerFromInfoInput_custom_text
object
4 properties
SignatureRequestLabel
object
2 properties 2 required
UpdateSignatureRequest
object
16 properties
SignatureRequest_SignerFromInfoInput_info
object
create new signer
5 properties 4 required
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.
New_Signature_Request_From_Scratch_template_placeholders_signers_inner
SignatureRequest_SignerFromContactIdInput
object
Create signer from a contact
7 properties 2 required
SignatureRequest_SignerFromUserIdInput
object
Create a signer from a user
7 properties 2 required
SignatureRequestInList_approvers_inner
object
2 properties 2 required
InternalServerError
object
2 properties 2 required
UnsupportedMediaTypeResponse
object
2 properties 2 required
SignatureRequestInList_sender
objectnull
2 properties
BadRequestResponse
object
2 properties 2 required
SignatureRequestInList_signers_inner
object
2 properties 2 required
SignatureRequestInList_documents_inner
object
2 properties 2 required
SignatureRequestStatus
string
SignatureRequest_SignerFromInfoInput
object
Create a signer from info
7 properties 2 required
SignatureRequest_PlaceholderReadOnlyTextFieldSubstituteInput
object
Create a placeholder readonlytext field substitute
2 properties 2 required
SignerDeliveryMode
stringnull
Override the delivery mode of the Signature Request for this Signer
Mention_2
object
9 properties 6 required
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…
TooManyRequestsResponse
object
1 property 1 required
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.
SignatureRequestActivated_documents_inner
object
2 properties 2 required
SignatureRequest_PlaceholderSignerSubstituteFromInfoInput_info
object
Create new signer
5 properties 4 required
HumanName
string

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.