> ## Documentation Index > Fetch the complete documentation index at: https://docs.cardinalgray.com/llms.txt > Use this file to discover all available pages before exploring further. # Sign Title Documents > Initiate signature process for title documents ## OpenAPI ````yaml POST /title/{id}/sign openapi: 3.0.1 info: title: Cardinal Gray OpenAPI description: OpenAPI for automating vehicle title work license: name: MIT version: 1.0.0 servers: - url: https://dev.cardinalgray.com description: Development - url: https://api.cardinalgray.com description: Production security: - bearerAuth: [] paths: /title/{id}/sign: post: description: >- Dispatch generated documents for signing, based on document-specific requirements. parameters: - $ref: '#/components/parameters/id' - name: Action in: query required: false schema: type: string enum: - ACTIVATE - BUMP description: >- Special action to perform on an existing signature request. ACTIVATE - Activates a draft signature request, BUMP - Sends a reminder to signers. requestBody: description: >- Customization options for the signature request (e.g., in cases where you don't want to collect signatures from all titled owners). content: application/json: schema: type: object properties: signers: type: array description: >- List of specific people who should sign the documents. If not provided, all current title owners will be included. items: $ref: '#/components/schemas/Person' documents_to_sign: type: array description: >- List of specific documents to be signed. If not provided, all required documents for a given transaction (loan, sale, etc.) will be included. items: $ref: '#/components/schemas/DocumentToSign' required: false responses: '200': description: Signature request created successfully content: application/json: schema: $ref: '#/components/schemas/SignatureRequest' '400': description: Missing required fields or invalid input content: application/json: schema: $ref: '#/components/schemas/Response' '403': description: Organization lacks necessary permissions content: application/json: schema: $ref: '#/components/schemas/Response' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: parameters: id: name: id in: path required: true schema: type: string description: Unique identifier of the title entry schemas: Person: allOf: - $ref: '#/components/schemas/Entity' - type: object properties: type: type: string enum: - PERSON - BUSINESS dob: type: string contact_phone: type: string contact_email: type: string dlid: $ref: '#/components/schemas/DriversLicense' ssn: type: string addr_mailing: $ref: '#/components/schemas/Address' insurance: $ref: '#/components/schemas/Insurance' ownership_type: type: string description: >- Type of ownership (e.g., SOLE, JOINT, LEASED, TRUST, registered_owner, titled_owner) is_nonobligor: type: boolean description: Whether this person is a non-obligor on the loan required: - dob DocumentToSign: type: object properties: filename: type: string id: type: string signer_id: type: array items: type: string signed_copy: type: string SignatureRequest: type: object properties: transaction_access_url: type: string description: URL for accessing the signature transaction redirect_url: type: object properties: url: type: string message: type: string required: - url requester_email: type: string description: Additional notification email for signature completion id: type: string description: >- Provider-specific ID (NTRZ::id for Notarize, DSGN::id for DocuSign, DMNS::id for Documenso, PNDC::id for Pandadoc) type: type: string enum: - WET_SIGN - WET_NOTARY - RON - E_SIGN description: Type of signature required status: type: string enum: - DRAFT - SENT - OPENED - COMPLETED - FAILED - EXPIRED description: Current status of the signature request documents_to_sign: type: array items: $ref: '#/components/schemas/DocumentToSign' created_at: type: string description: When the request was created updated_at: type: string description: Last status update signers: type: array items: $ref: '#/components/schemas/Person' sign_cert: type: string description: S3 path to signing certification collected_dlid: type: string description: S3 path to collected driver license ID full_export: type: string description: >- S3 path to full export consisting of sign cert, collected_dlid, and documents_to_sign physical_tracking: type: object properties: status: type: string tracking_url: type: string label_url: type: string shipment_id: type: string return_tracking_url: type: string return_label_url: type: string return_shipment_id: type: string instructions: type: string description: Any special instructions for the signer metadata: type: object additionalProperties: true description: Additional provider-specific metadata Response: type: object properties: error: type: string description: Error message statusCode: type: number description: HTTP status code Entity: type: object properties: id: type: string description: >- Use this field to pass your internal uuid for an entity, or let Cardinal Gray generate one type: type: string enum: - PERSON - DEALERSHIP - BUSINESS - LIENHOLDER description: Type of entity name: type: string description: >- Full name of owner in First Middle Last format. If found in Last, First Middle format, convert it name_first: type: string description: First name component name_middle: type: string description: Middle name component name_last: type: string description: Last name component name_suffix: type: string description: Name suffix (e.g., Jr., Sr., III) oats_names: type: array items: type: string description: >- Each additional name for the owner in First Middle Last format; do not confuse separate owners for an oats name description: >- Sometimes the same document can contain multiple names for the same person (i.e. the mailing info says Harper Smith but the section under titled or registered owners says John Smith-Avery), please list the additional names (in this case the former) in the oats_names array addr: $ref: '#/components/schemas/Address' description: Physical/residential address of the owner contact_phone: type: string description: Phone number for the owner contact_email: type: string description: Email address for the owner required: - type - name - addr DriversLicense: type: object properties: number: type: string description: Driver's license number state: type: string description: Two-letter code of state that issued the license sex: type: string description: Gender/sex as listed on license (typically 'M' or 'F') expiration_date: type: string description: License expiration date, format MM/DD/YYYY preferred first_name: type: string description: First name as it appears on license middle_name: type: string description: Middle name or initial as it appears on license last_name: type: string description: Last name as it appears on license suffix: type: string description: Name suffix (e.g., Jr., Sr., III) addr: $ref: '#/components/schemas/Address' description: Address as it appears on the driver's license required: - number - state - sex Address: type: object properties: recipient_name: type: string description: Name of the recipient at this address street1: type: string description: Primary street address line street2: type: string description: Secondary street address line (apartment, unit, etc.) city: type: string description: City name county: type: string description: County name state: type: string description: State abbreviation zip: type: string description: ZIP/postal code required: - street1 - city - state - zip Insurance: type: object properties: provider_name: type: string description: Insurance company name (e.g., 'GEICO', 'State Farm') provider_naic: type: string description: National Association of Insurance Commissioners code policy_number: type: string description: Insurance policy number description: Vehicle insurance information responses: NotFound: description: Not found content: application/json: schema: $ref: '#/components/schemas/Response' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Response' securitySchemes: bearerAuth: type: http scheme: bearer ````