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 Field API

Dynamic content that will appear on a Document.

YouSign Field 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 Field. 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 5 operations across 3 paths, and defines 62 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.

5 operations 3 paths 62 schemas 1 DELETE1 GET1 PATCH2 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 Field API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 5

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

Field 5

Dynamic content that will appear on a Document.

GET
/signature_requests/{signatureRequestId}/documents/{documentId}/fields
Lists the Fields of a Signature Request Document.
get-signature_requests-signatureRequestId-documents-documentId-fields 7 params → 200400401403404405429500
POST
/signature_requests/{signatureRequestId}/documents/{documentId}/fields
Create a new Field on a Document
post-signature_requests-signatureRequestId-documents-documentId-fields 2 params body → 201400401403404405415429
DELETE
/signature_requests/{signatureRequestId}/documents/{documentId}/fields/{fieldId}
Delete a Field
delete-signature_requests-signatureRequestId-documents-documentId-fields-fieldId 3 params → 204400401403404405429500
PATCH
/signature_requests/{signatureRequestId}/documents/{documentId}/fields/{fieldId}
Update a Field
update-signature_requests-signatureRequestId-documents-documentId-fields-fieldId 3 params body → 200400401403404405415429
POST
/signature_requests/{signatureRequestId}/documents/{documentId}/fields/{fieldId}/answer
Answer a Field
signature_requests-id-documents-id-fields-id-answer 3 params body → 204400401403404405429500

Schemas 62

The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are FieldSignatureDate (18 properties), FieldText (18 properties), Text (15 properties), Text_1 (14 properties). Each schema is shown below with its type and property counts.

UpdateField
object
RadioGroup_radios_inner
object
5 properties 2 required
ReadOnlyText_1
object
7 properties
get_signature_requests_signatureRequestId_documents_documentId_fields_200_response_data_inner
SignatureDisplay_oneOf
object
1 property 1 required
MethodNotAllowed
object
1 property 1 required
Signature_1
object
8 properties
Pagination
object
Metadata about the response.
1 property 1 required
Checkbox_1
object
9 properties
RadioGroup
object
7 properties 4 required
SignatureDate
object
13 properties 5 required
FontVariants
object
2 properties 2 required
FieldCheckbox
object
11 properties 10 required
FieldSignerEmail
object
12 properties 11 required
RadioGroup_1
object
6 properties
UUID
string
The unique identifier for a resource.
SignatureDisplay_oneOf_1_options
object
Only applicable when display.layout = detailed.
4 properties
CreateSignatureDateFieldFont
objectnull
Font configuration (family, size, color, style variants).
4 properties 4 required
get_signature_requests_signatureRequestId_documents_documentId_fields_200_response
object
2 properties
FieldRadioButtonGroup
object
8 properties 8 required
FieldAnswer
object
1 property 1 required
ForbiddenResponse
object
2 properties 2 required
SignatureDisplay_1
objectnull
Controls what is shown within the signature field.
Text_1
object
14 properties
SignerEmail
object
7 properties 5 required
NotFoundResponse
object
2 properties 2 required
ReadOnlyText
object
8 properties 5 required
FieldSignerName
object
13 properties 11 required
Text
object
15 properties 7 required
CreateFieldDateFormat
string
Format used to display the date (e.g., dd/MM/yyyy, MM/dd/yyyy)
CreateFieldOffsetUnit
stringnull
Unit of time used to offset the signature date. When null, the field will display the exact signature date.
FieldReadOnlyText
object
10 properties 10 required
CreateFieldTimeFormat
stringnull
Format used to display the time. Can be null to display only the date, or a format like HH:mm or hh:mm a
TooManyRequestsResponse
object
1 property 1 required
Detailed_layout
object
2 properties 2 required
Font
object
4 properties 4 required
FieldMention
object
12 properties 11 required
UpdateFieldFont
objectnull
If set, width and height properties become required. Otherwise, if not set the font will not be changed, and if set to null the default font will be used.
4 properties 4 required
Mention_1
object
9 properties
FieldRadioButtonGroup_radios_inner
object
5 properties 5 required
CreateFieldNameFormat
string
Format used to display the signer's name.
FieldSignatureDate
object
18 properties 11 required
Checkbox
object
10 properties 5 required
SignerName
object
8 properties 5 required
FieldText
object
18 properties 15 required
SignatureDate_1
object
12 properties
SignatureDisplay
object
Controls what is shown within the signature field.
FieldAnswer_value
RadioGroup_1_radios_inner
object
4 properties 2 required
Mention
object
10 properties 6 required
InternalServerError
object
2 properties 2 required
UnsupportedMediaTypeResponse
object
2 properties 2 required
Minimal_layout
object
1 property 1 required
FieldSignature
object
11 properties 11 required
CreateFieldFont
objectnull
If set, width and height properties become required. Otherwise, if not set or null, the default font will be used.
4 properties 4 required
CreateField
object
UnauthorizedResponse
object
2 properties 2 required
SignatureDisplay_oneOf_1
object
2 properties 2 required
Signature
object
9 properties 5 required
BadRequestResponse
object
2 properties 2 required
HumanName
string
FontFamily
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yousign-field-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 Field 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.